限频不是「每秒几次」,而是「每分钟多少权重」。一个查行情的接口可能只算 1,一个带参数的历史数据接口可能算 20,一个批量撤单接口可能一次吃掉几十。当你以为自己只发了 60 次请求时,服务器记录的可能是 800 权重。
更麻烦的是窗口类型:固定窗口和滚动窗口在同样的配额下,允许的瞬时速率差一倍。下面把权重、窗口、退避三件事拆开,给出可以直接套用的公式与一份六项核对清单。
一、权重:每个接口有自己的价格
主流交易所的 REST 接口文档会为每个端点标注「权重」(weight),同一个端点在不同参数下权重还可能不同——例如带 symbol 的查询算 1,不带 symbol 走全市场扫描算 40。IP 层面的额度是权重总和,不是请求次数。
这条公式是后面所有问题的根源:你优化的是「请求次数」,服务器统计的是「权重」,两者的比例取决于你调了哪些端点。
二、两种窗口:固定窗口给的是两倍瞬时额度
假设每分钟额度 W = 6,000 权重:
| 窗口类型 | 行为 | 边界风险 | 同一秒最多能发多少 |
|---|---|---|---|
| 固定窗口(按分钟重置) | 每分钟清零一次计数 | 在 :59 和下一秒 :00 各发满一次,瞬时翻倍 | 最高可到 2W |
| 滚动窗口(任一分钟内) | 任意连续 60 秒内累计不超过 W | 没有边界突刺,但持续速率被严格限制 | 不超过 W |
多数平台用的是滚动窗口,也就是「过去 60 秒内你用掉的权重」。这意味着补偿性突发(先攒着不发、然后一次发完)不但没用,还会直接把额度打满。写程序时不要依赖「整分钟对齐」来做批量任务。
三、公式:把权重预算换成最小间隔
如果每轮请求平均消耗 w̄ 权重,额度为 W/分钟,那么两轮之间至少要间隔:
例:轮询三个端点,权重分别为 1、5、20,每轮共 26 权重,W = 6,000:
60 × 26 ÷ 6,000 = 0.26 秒,也就是每秒最多约 3.8 轮。如果改成 1 秒一轮(60 轮/分钟),消耗 1,560 权重,安全;如果改成每 0.1 秒一轮(600 轮/分钟),消耗 15,600 权重,两分半就会触发封禁。
把公式倒过来用更实用:可支持的轮数 = W ÷ w̄。6,000 ÷ 26 ≈ 230 轮/分钟。任何超出这个数字的轮询计划,都必须先砍端点或降频。
四、429 与 418:两种状态码,两种应对
限频触发的响应通常分两级,含义完全不同:
- 429 Too Many Requests:本轮超出配额,请求被拒。响应头里常带
Retry-After,告诉你要等多久。这时候应该停下来,而不是立刻重试。 - 418 I’m a teapot(或被标记为 IP 封禁):已经触发了自动封禁,常见做法是按次数递增——先封 2 分钟,再犯延长到数小时甚至 3 天(币安等平台的文档明确写了这种递增)。这时候所有请求都会失败,重试只会延长封禁。
退避算法用指数加抖动,避免多个进程同时恢复形成二次冲击:
例:基数 1 秒、上限 60 秒,连续四次 429 后等待为 8 秒 × 随机系数(4–8 秒)。读 Retry-After 时优先用它,它比任何自算的退避都准确。
五、算例:一个真实形状的轮询循环
某脚本每 2 秒做一轮:查余额(权重 5)、查持仓(权重 5)、查成交(权重 20,带时间区间)、查行情(权重 1)。合计 31 权重/轮,30 轮/分钟 = 930 权重,占 6,000 的 15.5%。
| 改动 | 每分钟权重 | 占额度 | 结论 |
|---|---|---|---|
| 原始:2 秒一轮,31 权重 | 930 | 15.5% | 安全,还有余量 |
| 提速到 0.5 秒一轮 | 3,720 | 62% | 比其他任务共用 IP 时容易超 |
| 再改成不带时间区间查成交(权重 40) | 6,720 | 112% | 必然触发 429 |
第三行是最容易踩的坑:为了「拿全量数据」把参数去掉,权重从 20 跳到 40,一行改动就让额度超了 12%。改代码时权重表要跟着一起改。
六、六项核对
- 查清每个端点的权重,特别是「不带参数」时的权重——很多接口在缺参数时会走高权重分支。
- 确认平台用的是固定窗口还是滚动窗口;滚动窗口下不存在「整分钟对齐」的便宜可占。
- 按公式算出每分钟消耗,并给同一 IP 上的其他任务留出至少 30% 余量(网页后台、其他脚本、监控共用同一出口 IP)。
- 处理 429 时必须读
Retry-After;处理 418 时必须停止全部请求,不要换端点「绕过」。 - 用交易所返回的已用权重响应头(如
X-MBX-USED-WEIGHT-1M)做实时监控,而不是只靠自己计数。 - 把退避与抖动写进代码,别用固定 sleep;同时记录每次触发的端点与参数,否则永远找不到真正的权重黑洞。
七、常见问题
取决于权重。10 次轻量接口(权重 1)= 600/分钟,安全;10 次重量接口(权重 20)= 12,000/分钟,两倍超额。限频看权重总量,不看次数。
会继续累计违规。很多平台对反复触发的 IP 直接升级为 418 封禁,时长按次数递增,最长可达数天,期间所有接口都不可用。
技术上可能生效,但这是在规避平台风控条款,可能导致账户被限制;且 API key 的调用限制往往同时绑定账户维度,换 IP 不一定有用。
X-MBX-USED-WEIGHT-1M 响应头说明;OKX API 文档中的限频(Rate limit)章节(以上均访问日期 2026-11-01)。文中的权重数值与额度为示例,具体以各平台当前文档为准。