Genesis Arbitrage

Genesis Arbitrage · · 阅读约 5 分钟

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 的流量上限。