Коды ошибок

HTTP статусы и сообщения об ошибках.

HTTP статусы

КодОписание
200Успех
400Bad Request — неверные параметры
401Unauthorized — требуется авторизация
403Forbidden — доступ запрещён
404Not Found — ресурс не найден
429Too Many Requests — превышен лимит
500Internal Server Error

Формат ошибки

{
  "error": "Invalid token_id",
  "code": "INVALID_PARAMETER",
  "details": {
    "parameter": "token_id",
    "value": "invalid"
  }
}

Типичные ошибки

КодОписаниеРешение
INVALID_PARAMETERНеверный параметрПроверьте формат параметра
MISSING_PARAMETERОтсутствует параметрДобавьте обязательный параметр
INVALID_SIGNATUREНеверная подписьПроверьте HMAC подпись
EXPIRED_TIMESTAMPУстаревший timestampИспользуйте актуальное время
INSUFFICIENT_BALANCEНедостаточно средствПополните баланс
MARKET_CLOSEDРынок закрытРынок не принимает ордера
ORDER_NOT_FOUNDОрдер не найденПроверьте order_id

Rate Limits

При превышении лимитов возвращается 429 Too Many Requests:

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

Заголовки ответа содержат информацию о лимитах:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705330200

Рекомендации

• Реализуйте exponential backoff при 429

• Кэшируйте публичные данные

• Используйте WebSocket вместо polling

• Проверяйте timestamp перед запросами