Ошибки
Ошибка — HTTP-статус и объект error. Код в error.code постоянный, на него и опирайтесь; message пишется для людей и может меняться.
Формат
Кроме code и message, в error бывают field, limits, suggestion.via, retryAfter и state — смотря по ошибке.
{
"error": {
"code": "amount_below_min",
"message": "The amount is below the minimum",
"limits": {
"min": "12.4",
"max": "96500",
"asset": "USDT"
}
}
}Исправить запрос
Повтор без изменений не поможет.
invalid_json400Тело — не JSON-объект.invalid_request400Поле из field отсутствует или неверно.same_asset400Отправка и получение — один актив.invalid_address400Адрес не подходит к активу и сети.refund_address_required400Для refund нужен refund.address.quote_invalid400Котировка выдана другому проекту или изменена.project_required400У ключа несколько активных проектов — укажите X-Project.report_invalid400Токен AML-отчёта чужой или изменён.Запросить заново
Нужна новая котировка или другая сумма.
quote_expired410Срок котировки вышел.amount_below_min422Сумма меньше минимума; пределы — в limits.amount_above_max422Сумма больше максимума; пределы — в limits.reserve_exceeded422Сумма больше доступного резерва.no_route422Пару нельзя обменять напрямую. Если можно в два шага — промежуточный актив в suggestion.via.deposit_unavailable422Приём актива сейчас закрыт.payout_unavailable422Выплата актива сейчас закрыта.quote_unavailable422Курс сейчас не получить — повторите через минуту.aml_unsupported_network422Эту сеть не проверить; список — /aml/networks.Состояние заявки
Запрос верный, но заявка в другом состоянии.
order_not_found404Нет такой заявки у этого проекта.order_expired410Срок заявки вышел, она закрыта.decision_not_expected409Заявка не ждёт решения; текущее состояние — в state.request_in_progress409Запрос с тем же Idempotency-Key ещё выполняется; повторите через retryAfter.Доступ
Проверьте ключ и проект в кабинете.
unauthorized401Нет заголовка Authorization: Bearer hx_secret_….invalid_key401Такого ключа нет.key_inactive403Ключ отключён — выпустите новый.project_not_found403У ключа нет такого проекта.project_not_approved403Проект ещё на проверке.project_rejected403Проект отклонён — исправьте карточку.project_blocked403Проект заблокирован — пишите в поддержку.project_inactive403Проект выключен.owner_blocked403Заблокирован аккаунт владельца.access_denied403Нет доступа к действию.partner_fee_not_allowed403Проекту не разрешена наценка.referral_not_allowed403Проекту не разрешена метка referral.aml_not_enabled403AML-проверки не подключены.Подождать
Повторите позже, ничего не меняя.
rate_limited429Лимит ключа исчерпан; ждите retryAfter секунд.maintenance503Технические работы.aml_unavailable503AML-проверка временно недоступна.aml_quota_exhausted503Лимит AML-проверок исчерпан — пишите в поддержку.upstream_error5xxЗапрос не удалось обработать.internal500Ошибка на нашей стороне.