CSBoard API 速率限制以及如何处理 429 错误

HTTP/1.1 200 OK
X-RateLimit-Limit: 3000
X-RateLimit-Remaining: 2987
X-RateLimit-Reset: 41
X-RateLimit-Bucket: trading

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 23
X-RateLimit-Bucket: read
Content-Type: application/json

{
  "code": "rate_limit_exceeded",
  "detail": "Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.",
  "bucket": "read",
  "limit_per_min": 100,
  "retry_after_sec": 23
}

{ "code": "snapshot_rate_limited", "detail": "Snapshot is limited to 1/min. Poll less or cache it." }

{
  "code": "too_many_streams",
  "detail": "At most 3 concurrent streams per key. Close an existing connection first — one stream carries the whole catalogue, so you do not need several. A connection that dropped without closing frees its slot within 90 s.",
  "max_connections": 3,
  "retry_after_sec": 90
}

{ "error": "Rate limit exceeded, retry in 37 seconds", "statusCode": 429 }

header() {
  echo "$RESPONSE" | grep -i "^$1:" | awk '{print $2}' | tr -d '\r'
}

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=$(header retry-after)
    echo "Rate limited. Waiting ${RETRY_AFTER}s..."
    sleep "$RETRY_AFTER"
  else
    echo "$RESPONSE" | tail -1  # print body

    # 本分钟的最后一次请求：等窗口重新开始后再发下一次。
    if [ "$(header x-ratelimit-remaining)" = "0" ]; then
      sleep "$(header x-ratelimit-reset)"
    fi
    break
  fi
done