HTTP 429 Too Many Requests
HTTP 429 Too Many Requests 是服务器在客户端短时间内发送过多请求、触发限流时返回的状态码。该状态码于 2012 年由 RFC 6585 引入。标准没有规定请求如何计数:按密钥、IP 地址还是资源,按秒还是按小时,因此每个服务都有自己的规则。
如何处理 429
下面的函数请求资金费率价差,并在收到 429 和 503 后重试:
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_with_retry(params, attempts=5):
delay = 1
for _ in range(attempts):
r = requests.get(URL, headers=HEADERS,
params=params, timeout=10)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
wait = r.headers.get("Retry-After", "")
# 优先使用服务器给出的等待时间,否则 1、2、4…… 秒
time.sleep(int(wait) if wait.isdigit() else delay)
delay = min(delay * 2, 60)
raise RuntimeError("仍被限流:请降低轮询频率")
rows = get_with_retry({"min_spread": 0.05})
print("资金费率价差达到 0.05% 或更高的币种数量:", len(rows))
将间隔翻倍的做法叫指数退避。不等待就重试,很可能再次收到 429。如果机器人有多个副本在发送请求,请在每次等待时间上再加一个随机的小数秒,避免它们的重试在同一时刻到达。
Genesis API 中的 429
Genesis API 返回 429,响应体中带有两种代码之一,并附带 Retry-After 头:
| 代码 | 何时出现 | 应对方法 |
|---|---|---|
rate_limited | 超出每秒请求数限制:Trial 为 1,Max 为 15 | 等待 Retry-After,将请求分散到不同时间 |
download_limited | 每个密钥每 10 秒的压缩数据超过 60 MB | 等待窗口结束,用筛选参数和 coin 缩小查询范围 |
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}
超出限制的请求不会计费:只有 200 响应才算一次调用,429 和其他错误一样不占用你的额度。但错误仍计入每秒请求数限制,所以连续快速重试会引发新的 429。X-RateLimit-Remaining 头显示当前窗口的剩余量,X-Quota-Remaining 显示剩余额度。
另见:API 轮询、ETag 与 If-None-Match、Genesis API 文档中的错误、Genesis API 限制。
常见问题
429 与 503 有什么区别?
429 表示你请求得太频繁。在 Genesis API 中,带 snapshot_not_ready 代码的 503 表示数据正在重建或其来源正在重启:请在 Retry-After 秒后重试。
机器人请求很少,为什么还会收到 429?
限制按密钥计算,所以共用同一个密钥的两个脚本共享限制。另一个原因是频繁地不带筛选参数完整下载,触及了 download_limited 的流量上限。