币安 API 报 429 之后继续发请求就会被封 IP 改报 418

等待时长写在每次被拒的响应头里;脚本真正要改的是收到 429 之后的反应,以及行情数据从哪里取。
脚本日志里先是一串 429,过一阵变成 418:到这一步,这台机器的出口 IP 已经被币安自动封禁。418 跟 API Key、签名都扯不上关系,它是前面收到 429 之后还在继续请求换来的。
先把脚本停住,systemd、pm2 这类守护进程的自动重启也一起关掉,不然脚本被拉起来又会接着发请求。然后从最后一个 418 响应的头里取 Retry-After,这个数是离解封还剩的秒数。等它走完、照第 2 节把退避逻辑改好,再重新启动脚本。
1. 从状态码和 -1003 的提示句认出是限流、封 IP 还是防火墙拦截 #
HTTP 状态码告诉你大类,响应正文 JSON 里的 code 和 msg 再细到具体原因。跟「请求太多」沾边的返回有下面这些:
| 你看到的返回 | 它说明什么 | 接下来做什么 |
|---|---|---|
| HTTP 429 | 超出了请求频率限制 | 按响应头 Retry-After 的秒数停下,放慢节奏再继续 |
| HTTP 418 | 收到 429 后仍在持续请求,IP 已被自动封禁 | 停掉脚本,按第 2 节等到解封 |
| HTTP 403 | 触发了 WAF(Web 应用防火墙)规则,原因可能是超限,也可能是安全拦截 | 检查请求参数,见文末第 3 问 |
-1003Too many requests queued. | 排队等处理的请求太多 | 减少同时发出的请求 |
-1003Too much request weight used; current limit is %s request weight per %s. Please use WebSocket Streams for live updates to avoid polling the API. | 用掉的请求权重超了,两个 %s 处分别填当前上限和时间单位 | 记下这两个值,找出耗权重的请求(第 3 节) |
-1003Way too much request weight used; IP banned until %s. Please use WebSocket Streams for live updates to avoid bans. | 权重超得太多,IP 已被封,until 后面是解封时间 | 和 418 一样处理 |
-1015 TOO_MANY_ORDERSToo many orders placed without trading; current limit is X non-trading orders per Y. Unable to place new orders until trades occur or window resets.旧:Too many new orders; current limit is %s orders per %s. | 没成交的新单太多(新提示文字随 2026 年 11 月 11 日的更新分批上线,官方说约两周完成;下面一行是旧文字) | 放慢下单频率;等有成交或时间窗口重置,详见币安API报-1015:撤单不减计数,下单上限怎么算 |
| HTTP 5XX、-1007 TIMEOUT | 币安一侧的内部错误或超时,执行状态未知 | 下单请求先查单,见开头的提醒 |
-1003 下面的后两种消息,结尾都附了同一条建议:实时数据改用 WebSocket Streams,少轮询 REST 接口。错误码是固定的,消息文字会变,同一个 code 对应好几种 msg,脚本判断时别只比对 code,把 msg 也打进日志,才分得清是排队太多、权重超限还是已经被封。
下单数量另有一套计数。每个成功下单的响应都带 X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter) 头,显示这个时间段里下了多少单,想单独盯着可以调 GET api/v3/rateLimit/order;被拒或失败的订单不保证带这个头。未成交订单数超了,同样收到 429 和 Retry-After。挂出去的单如果持续被成交,就可以一直通过 API 下单。
返回的如果是 -2015,问题在 Key、IP 白名单或接口权限,和限频无关,按币安 API 报 -2015 是 Key、IP 还是权限没对上里的顺序去查。
2. 被封成 418 之后要等多久看响应头 Retry-After #
Retry-After 在 429 和 418 两种响应里都会出现,单位是秒,含义差一点:收到 429 时,它是为了不被封需要等的秒数;收到 418 时,它是离封禁结束还剩的秒数。等多久照这个数来,脚本里别写一个固定值。
封禁时长不固定。币安会记录每个 IP 被封的情况,屡次触犯的,封禁时间逐次拉长,从 2 分钟起,最长到 3 天。假设脚本里写死「被拒就等 60 秒再试」,60 秒连最短的 2 分钟都不到,醒来时封禁还没结束,请求照样被拒。
查询类的 GET 请求,可以套一层这样的包装:
import time
import requests
def get_with_backoff(url, make_params, headers):
while True:
params = make_params() # 每次调用都重新取 timestamp、重新签名
resp = requests.get(url, params=params, headers=headers)
used = {k: v for k, v in resp.headers.items()
if k.lower().startswith('x-mbx-used-weight-')}
print(resp.status_code, used)
if resp.status_code not in (429, 418):
return resp
retry_after = resp.headers.get('Retry-After')
if retry_after is None:
raise RuntimeError('响应里没有 Retry-After,停下来人工查看')
time.sleep(int(retry_after))
写法上要留意的地方:
- 签名放在循环里重新算。等过一段 Retry-After 之后,之前签好的请求,时间戳可能已经超出 recvWindow(不发时默认 5000 毫秒,最大 60000 毫秒),原样重发会被拒。相关的报错和排查顺序见币安 API 报 -1021 怎么办:时间戳超出 recvWindow 的排查顺序。
- 找不到 Retry-After 就抛错停下,交给人看,不去猜一个秒数。
- 只包查询,不包下单。下单请求遇到超时、5XX,按开头那条提醒先查单。
脚本如果由守护进程托管,还有一种做法是收到 418 就让脚本直接退出,同时关掉守护进程的自动重启,等 Retry-After 走完再手动拉起。脚本一启动就请求接口的,千万别让它在被封期间秒级重启。
3. 让 AI 改脚本时先给它看响应头里的权重和 Retry-After #
每个响应头里都带 X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter),值是当前这个 IP 在各个限频器下已经用掉的权重。intervalLetter 取 S、M、H、D,对应秒、分、时、天;intervalNum 是几个这样的单位,比如 5 配 M 就是每 5 分钟。每个接口有自己的权重,较重的接口、一次处理多个交易对的接口,权重更高。
429 反复出现时,要找的是哪些请求在不停地消耗权重。让 AI 修之前,先让它看真实数据,别让它凭印象估哪个接口重:
- 在每次请求之后加一行日志,记下接口路径、状态码和所有以
X-MBX-USED-WEIGHT-开头的响应头,让脚本按平时的节奏跑一段时间。 - 把这段日志,连同一条 429 或 418 的完整返回(状态码、响应头、JSON 正文)贴给 AI。贴之前删掉请求头里的
X-MBX-APIKEY和参数里的signature;API Key 和 Secret Key 都不要交给任何人,AI 对话也一样。 - 要它逐项回答:这条返回对应第 1 节表格里哪一行,Retry-After 是多少秒,日志里哪个接口消耗的权重最多,哪些请求可以合并、拉长间隔或者干脆去掉。
- 交代清楚上限数值一律从
/api/v3/exchangeInfo读,不许它在代码里填一个自己估的数。 - 改完让它按函数列出改动,你对照原代码一处处看,重点看重试逻辑有没有把下单请求也包进去。
日志里权重的大头如果是反复拉行情的请求,改法就是 -1003 提示句里劝的那条:实时数据改订阅 WebSocket Streams,别用 REST 接口一遍遍轮询。只拉公开行情、不碰账户的脚本,文档给的基础地址是 https://data-api.binance.vision;下单、查账户这类签名请求还是走原来的 https://api.binance.com。
一次处理多个交易对的接口权重更高。脚本只关心三五个币对的,让 AI 检查哪些接口能按 symbol 单独查询,只请求这几个,别每次把全部交易对拉回来再在本地筛。改完先让新脚本跑一段,对照改前的日志,看 X-MBX-USED-WEIGHT 的值是不是降下来了。
4. 脚本恢复之前先确认额度和报错落在哪一层
换个币安 API Key 能绕开限频吗?
换 Key 绕不开,币安现货 API 的请求频率按 IP 计算,不按 API Key 计算。同一台服务器上跑三个脚本、配三把不同的 Key,权重仍记在这台机器的出口 IP 上,三个脚本的请求加在一起算。下单数量这一项另算,未成交订单数按账户统计。
币安 API 的权重上限在哪里看?
在 /api/v3/exchangeInfo 返回的 rateLimits 数组里,分 RAW_REQUESTS、REQUEST_WEIGHT、ORDERS 三类。脚本启动时读一次存起来,别把数字写死在代码里;运行中拿每个响应头 X-MBX-USED-WEIGHT 的已用值去比,就知道离上限还差多少。
币安 API 返回 403 说明 IP 被封了吗?
403 对应的是 WAF(Web 应用防火墙)规则被触发,超限和安全拦截都能引出它,和限频之后自动封 IP 的 418 不是同一种返回。请求参数里带 SQL 关键字可能触发 WAF 的安全拦截,遇到 403 先看参数里有没有这类字眼。
币安 API 报 -1008 SERVER_BUSY 怎么办?
-1008 的提示是服务器正被其他请求压满,请你过几分钟再试。它在错误码页里和限频的 -1003 分开列,等几分钟再发查询即可。出在下单请求上的,重发之前先查一下这笔订单有没有挂上,避免同一笔单下两次。