Лимиты запросов API CSBoard и обработка ошибок 429

API CSBoard применяет лимиты запросов на каждый ключ, чтобы сохранять стабильность сервиса для всех пользователей. Если вы превышаете лимит, то сразу получаете ответ 429 — ни один запрос не обрабатывается частично. Реализуйте клиент так, чтобы он считывал заголовок Retry-After и делал паузу перед повтором, а не долбил эндпоинт в плотном цикле.

Лимиты по эндпоинтам

Все лимиты действуют на API-ключ и сбрасываются в скользящем окне 60 секунд.

Лимит	Эндпоинт(ы)
30 / мин	Listings, prices, currency, balance и статус ордера — все стандартные эндпоинты `GET`
30 / мин	`POST /v1/orders` (размещает ордер на покупку и расходует реальные деньги)
1 / мин	`GET /v1/prices/snapshot.ndjson.gz` (массовый сжатый снапшот)

Отправка более 30 запросов с неверными или отсутствующими API-ключами с одного IP-адреса в течение одной минуты автоматически приводит к 5-минутному бану на уровне IP. Во время бана каждый запрос с этого IP возвращает 401 too_many_failed_auth независимо от того, какой ключ используется. Переключитесь на действительный ключ и дождитесь окончания cooldown перед повтором.

Формат ответа 429

При превышении лимита стандартного эндпоинта API возвращает:

HTTP/1.1 429 Too Many Requests
Retry-After: 14
Content-Type: application/json

{ "code": "rate_limit_exceeded", "detail": "Rate limit exceeded. Retry after 14 seconds." }

Значение заголовка Retry-After — целое число секунд, которые необходимо подождать, прежде чем следующий запрос будет успешным. Эндпоинт массового снапшота использует отдельный код ошибки при превышении лимита:

{ "code": "snapshot_rate_limited", "detail": "Snapshot rate limit exceeded. Retry after 60 seconds." }

Обработка 429 в клиенте

Считывайте Retry-After и спите как минимум столько секунд, прежде чем повторять запрос. Ниже показан простой цикл повторов на bash:

while true; do
  RESPONSE=$(curl -si https://csboard.com/v1/listings \
    -H "Authorization: Bearer csb_pub_...")

  STATUS=$(echo "$RESPONSE" | head -1 | awk '{print $2}')

  if [ "$STATUS" = "429" ]; then
    RETRY_AFTER=$(echo "$RESPONSE" | grep -i "retry-after" | awk '{print $2}' | tr -d '\r')
    echo "Rate limited. Waiting ${RETRY_AFTER}s..."
    sleep "$RETRY_AFTER"
  else
    echo "$RESPONSE" | tail -1  # print body
    break
  fi
done

Добавьте небольшое случайное смещение (например, sleep $((RETRY_AFTER + RANDOM % 5))) при запуске нескольких воркеров параллельно, чтобы они не возобновляли работу одновременно и не срабатывали по лимиту снова.

Повышение лимитов

Стандартные лимиты подходят для большинства интеграций, но если у вас сценарий с высокой нагрузкой — например, конвейер данных или высокочастотный торговый бот — свяжитесь с нами, чтобы обсудить более высокий лимит на ключ для вашей учётной записи.

Начало работы

Инструкции

Лимиты запросов API CSBoard и обработка ошибок 429

Лимиты по эндпоинтам

Формат ответа 429

Обработка 429 в клиенте

Повышение лимитов

​Лимиты по эндпоинтам

​Формат ответа 429

​Обработка 429 в клиенте

​Повышение лимитов

Лимиты по эндпоинтам

Формат ответа 429

Обработка 429 в клиенте

Повышение лимитов