目录
文章目录
  1. 1. 从状态码和 -1003 的提示句认出是限流、封 IP 还是防火墙拦截
  2. 2. 被封成 418 之后要等多久看响应头 Retry-After
  3. 3. 让 AI 改脚本时先给它看响应头里的权重和 Retry-After
  4. 4. 脚本恢复之前先确认额度和报错落在哪一层

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

币安现货 API 限频规则要点:每个响应头 X-MBX-USED-WEIGHT 显示该 IP 已用权重,每个接口有各自的 weight,收到 429 必须退避,反复超限会被自动封 IP 并返回 418,屡犯者封禁时长从 2 分钟到 3 天,Retry-After 给出要等的秒数,限频按 IP 而不是 API Key 计算
反复超限、收到 429 后不退避,IP 会被自动封禁并收到 418;到 2026 年 11 月,屡犯者的封禁时长按 2 分钟到 3 天逐级拉长。

等待时长写在每次被拒的响应头里;脚本真正要改的是收到 429 之后的反应,以及行情数据从哪里取。

2026-11-09 发布 PromptDeck 撰 阅读约 8 分钟 约 2,400 字
范围:币安现货 REST 接口返回的 HTTP 429、418、403,以及错误码 -1003、-1015。U 本位合约和 WebSocket API 的限频另有各自的文档;权重上限的具体数值从 exchangeInfo 读取,别写死在脚本里(读法见文末第 2 问)。
下单请求超时或返回 5XX,先查单再说:5XX 表示问题出在币安一侧,但这笔请求的执行状态未知,有可能已经成交。-1007 TIMEOUT 同理,API 处理一个请求最多等 10 秒,撮合引擎没在这段时间内回话就返回这一条,提示里写着发送状态和执行状态都未知,并不一定代表下单失败。先看 User Data Stream 里有没有这笔订单的状态,那里没有就调查询接口查,确认没挂上再重发。

脚本日志里先是一串 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 问
-1003
Too many requests queued.
排队等处理的请求太多减少同时发出的请求
-1003
Too 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 节)
-1003
Way 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_ORDERS
Too 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))

写法上要留意的地方:

脚本如果由守护进程托管,还有一种做法是收到 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 修之前,先让它看真实数据,别让它凭印象估哪个接口重:

  1. 在每次请求之后加一行日志,记下接口路径、状态码和所有以 X-MBX-USED-WEIGHT- 开头的响应头,让脚本按平时的节奏跑一段时间。
  2. 把这段日志,连同一条 429 或 418 的完整返回(状态码、响应头、JSON 正文)贴给 AI。贴之前删掉请求头里的 X-MBX-APIKEY 和参数里的 signature;API Key 和 Secret Key 都不要交给任何人,AI 对话也一样。
  3. 要它逐项回答:这条返回对应第 1 节表格里哪一行,Retry-After 是多少秒,日志里哪个接口消耗的权重最多,哪些请求可以合并、拉长间隔或者干脆去掉。
  4. 交代清楚上限数值一律从 /api/v3/exchangeInfo 读,不许它在代码里填一个自己估的数。
  5. 改完让它按函数列出改动,你对照原代码一处处看,重点看重试逻辑有没有把下单请求也包进去。

日志里权重的大头如果是反复拉行情的请求,改法就是 -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 分开列,等几分钟再发查询即可。出在下单请求上的,重发之前先查一下这笔订单有没有挂上,避免同一笔单下两次。

风险与链接说明:本页依据币安开发者文档现货 REST API 的通用信息与 LIMITS 说明、现货错误代码页整理,限频规则会随文档更新而调整。不构成投资建议;用脚本在实盘下单可能造成资金损失,运行前请确认你所在地区能否使用。 本站部分评测页含币安推介链接,经这些链接注册,本站可能获得佣金;这篇排错文没有放推介链接。 完整披露 →