Проблемы и FAQ (Relay)

Официально: Troubleshooting · Handling Quote Errors · Rate Limits

401 UNAUTHORIZED_QUOTE#

Котировка с полем referrer без валидного x-api-key. Уберите referrer или задайте RELAY_API_KEY на сервере портала.

429 rate limits#

Слишком частые запросы. Снизьте polling / quote-частоту; с ключом лимиты выше. Дефолты и elevated — в API keys.

Disabled / lagging chains#

В /chains смотрите disabled и blockProductionLagging. Не стройте маршруты на отключённые сети.

Статус «висит» на waiting / pending#

1. Убедитесь, что origin-tx из steps действительно отправлена и подтверждена.
2. Опрашивайте /intents/status/v3?requestId=… (~1/с) или webhook.
3. Lifecycle: waiting → depositing/pending → success; иначе refund flow — Refunds.

Котировка «дорогая» / нет маршрута#

Проверьте tokenSupport, ликвидность и сумму. Для preview — indicativeQuote (см. quote/v2). Platform fee зависит от типа пары (bridge / stable / major / minor).

Прокси портала отвечает 403#

Путь не в allowlist. Разрешены только: GET chains, POST currencies/v2, POST quote/v2, GET intents/status/v3.