Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
了解所有 CSBoard API 端点的每密钥请求限制、读取 Retry-After 头部，并实现正确的 429 退避逻辑。
429 响应——不会有请求被部分处理。请构建您的客户端以检查 Retry-After 头部并在重试前暂停，而不是在紧密循环中持续冲击端点。
| 限制 | 端点 |
|---|---|
| 30 / 分钟 | 挂单、价格、货币、余额和订单状态——所有标准 GET 端点 |
| 30 / 分钟 | POST /v1/orders（下达购买订单并消费真实资金） |
| 1 / 分钟 | GET /v1/prices/snapshot.ndjson.gz（批量压缩快照） |
401 too_many_failed_auth。请轮换到有效密钥并等待冷却期结束后再重试。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." }
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))），这样它们就不会在同一瞬间全部恢复并立即再次触发限制。