脚本在凌晨两点开始抛 429,很多人的第一反应是「账号被封了」,于是换 IP、换密钥、重启程序,第二天照样报。真正的原因通常很简单:交易所按「权重」计费,不按请求条数计费,你在一个 for 循环里把当分钟的预算打光了。
一、权重预算,不是请求次数
公开文档里能查到三条并行的限制线:请求权重(通常按分钟、按 IP 计)、订单速率(按秒计)、订单总量(按天计)。以币安现货 API 的公开文档为例:每个 IP 每分钟 6,000 权重,下单 100 笔/10 秒、200,000 笔/天。
每分钟可调用次数 ≈ 6,000 ÷ 单请求权重权重 1 的接口一分钟能打 6,000 次;权重 20 的接口只有 300 次。同样是「一次请求」,成本差 20 倍。所以限流器必须按权重做,按次数做必然在某一类重接口上翻车。
二、四类接口的预算换算
| 请求类型 | 示例权重 | 理论每分钟上限 | 留 30% 余量后 |
|---|---|---|---|
| 单交易对行情查询 | 1–2 | 3,000–6,000 | 2,100–4,200 |
| 账户、订单、成交查询 | 5–10 | 600–1,200 | 420–840 |
| 下单与撤单 | 1–10,另受订单速率线约束 | 由速率线决定 | 按 70 笔/10 秒规划 |
| 历史 K 线批量拉取 | 20 以上 | ≤300 | ≤210 |
表里的权重是量级示例,具体数值以官方文档当天的页面为准——交易所调整权重不会单独发公告,只会改文档。把权重读进配置表,别硬编码在代码里,是被 429 教育过的人共同的教训。
三、429 和 418 不是一回事
- 429 Too Many Requests:本次请求超出限制。响应头通常带
Retry-After,部分交易所还会返回已用权重(如X-MBX-USED-WEIGHT-1M)。这是提醒,不是处罚。 - 418:在持续超限或违规请求之后被自动拉黑,公开文档的口径是 2 分钟到 3 天不等。这时候继续重试只会延长封禁时间——每多发一个请求,计时器就可能重置一次。
四、六步退避清单
- 先读响应头:把
Retry-After和已用权重写进日志,不要靠猜间隔。 - 指数退避加抖动:1s、2s、4s、8s 递增,每次叠加 ±20% 随机量,避免所有进程在同一秒集体重试。
- 用全局令牌桶:按权重扣令牌,扣不到就排队等待,而不是在每个函数里各写一个 sleep。
- 能批量就批量:批量下单、批量撤单、一次查多个交易对,把固定开销摊薄。
- 监控已用权重:把「已用 / 上限」做成指标,超过 70% 告警,不要等 429 才发现。
- 确认限频维度:按 IP 还是按 UID,按分钟还是按 10 秒。多台机器共用一个出口 IP 时,预算是共享的。
五、常见误用
- 把 429 当封号,立刻换密钥——限的是 IP 和权重,换密钥没有用。
- 只给下单接口加限流,忘了行情轮询才是权重消耗的大头。
- 用固定 sleep 代替限流器,行情剧烈时被自己的高频轮询拖死。
- 不开 IP 白名单就把密钥丢进云函数,多地出口 IP 各自计费,行为无法预测。
- 用重试掩盖逻辑错误:请求参数错了也会失败,重试一百次只是把错误放大一百倍。
常见问题
先看 Retry-After;没有这个头就从 2 秒起步做指数退避,连续三次仍失败就整体停 60 秒再试。最忌讳的是在同一秒内反复重试——那等于主动把自己送进 418。
主流交易所对公开行情接口按 IP 计,对账户类接口按 UID 计,下单还有一条独立的速率线。同一台机器上跑多个进程、多份策略时,它们共享同一份预算,所以限流器必须是进程外的全局组件。
Q3:多申请几个 API Key 能绕过限频吗?不能。同一 UID 下的多个 Key 共享账户级限频,同一出口 IP 又共享 IP 级限频。要多开只能多账户加多出口,而这属于合规敏感操作,多数交易所的服务条款对此有明确限制,风险由账户持有人承担。
Q4:本地回测跑得好,实盘一开就报错,是限频问题吗?先看错误码。429 是限频,401/403 是签名或权限,400 多半是参数(精度、最小下单量、时间戳偏移)。签名错误的典型表现是「服务器时间与本地时间偏差超过 recvWindow」,这一类重试永远不会成功。
相关阅读
1. 币安现货 API 公开文档「IP Limits / Order Rate Limits」章节:6,000 权重/分钟/IP、下单 100 笔/10 秒、200,000 笔/天。
2. OKX API 文档「Rate limit」章节:各接口独立限频与 429 返回约定。
3. RFC 6585 第 4 节:429 Too Many Requests 状态码与 Retry-After 头的定义。
4. 本站旧文《API Key 权限:只开读取与交易,提币权限为什么必须关》。
本文只讨论接口工程与限流实现,不构成投资建议;合约交易存在爆仓风险。