脚本撤掉旧单再重挂新单时被币安 API 返回 -1015

上限从 exchangeInfo 读,剩余额度看下单响应头;挂单类脚本真正要改的,是撤了又重挂的次数。
下单接口回了 HTTP 429,JSON 里的 code 是 -1015。拦下这笔单的不是请求权重,是币安现货另一套未成交订单计数:当前时间窗口里,这个账户下出去、到现在还一笔没成交的新单已经顶到了上限。
这时候让脚本停止下新单就行,不必忙着撤单腾位置,撤单不会让这个计数往回减。要等几秒,看这条 429 响应头里的 Retry-After;响应头里没带它,就让脚本停下新单并发通知,别自己估一个秒数。窗口过去以后,照第 2 节把账户的下单上限读出来,再照第 3 节改重挂的节奏。
1. 撤掉和过期的订单为什么还占着 -1015 的名额 #
这套计数只数一样东西:某个时间段里新下的、还没成交的订单。每成功下出一笔新单,当前窗口的计数加 1;一笔单第一次成交时,部分成交和全部成交都算,ORDERS 名下每个时间窗口的计数各减 1。撤单不改变计数,订单过期也不改变,FOK 单没成交就过期的,照样留在计数里。
挂单类脚本的麻烦就在这里。行情一动就撤掉旧单、按新价重挂,每重挂一次都是一笔新单,而撤掉的那笔下单时已经记过数。日志里看着盘口上始终只挂着三五笔,窗口里的计数却一直在往上涨。
假设某个 10 秒窗口里发生了这些事:
- 脚本成功下出 12 笔限价单;
- 其中 8 笔没等到成交就被撤掉;
- 3 笔一挂出去就以吃单方式全部成交;
- 剩下 1 笔是 FOK 单,没有成交,直接过期。
这个窗口的计数 = 成功下出的新单数 − 第一次成交的订单数 = 12 − 3 = 9。撤掉的 8 笔和过期的 1 笔都还算在这 9 笔里。从 exchangeInfo 读到的这一档上限记作 L,窗口结束前还能再下 L − 9 笔。脚本要是只数「盘口上还挂着几笔」,得出的是 0,因为这 12 笔已经一笔都不挂着了,算出来的余量就比实际多了 9 笔。
有两种成交会让计数一次减得更多:没有立刻成交、挂在盘口等到第一次成交的订单(挂单方成交),以及成交数量大的订单,一笔就可能减掉不止 1。上面那 3 笔都是吃单,所以各减 1。
还有两条边界。计数减到 0 就停,不会变成负数,多出来的成交不能存着抵以后的新单。从订单成交到计数更新之间有一小段延迟,计数贴着上限的时候,刚成交的那几笔未必已经减下来,别卡在线上连续下单。
2. 账户的下单上限去 exchangeInfo 的 ORDERS 项里读 #
当前的未成交订单上限用「交易所信息」请求查:REST 是 GET /api/v3/exchangeInfo,WebSocket API 是 exchangeInfo,FIX API 用 LimitQuery<XLQ> 消息。返回的 rateLimits 数组里分 RAW_REQUESTS、REQUEST_WEIGHT、ORDERS 三类,"rateLimitType": "ORDERS" 的那几条就是下单计数的上限,每条带 interval(时间单位)、intervalNum(几个单位)和 limit(上限)。读出来不止一条 ORDERS,就是几个窗口在同时计数,哪一条先满,新单都会被拒。
线上的实际配置可能和文档里的示例不同。脚本启动时读一次存起来,代码里别写死一个数:
import requests
info = requests.get('https://api.binance.com/api/v3/exchangeInfo').json()
for item in info['rateLimits']:
if item['rateLimitType'] == 'ORDERS':
print(item['interval'], item['intervalNum'], item['limit'])
跑起来以后,剩多少额度靠响应头盯。每个成功的下单响应都带 X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter),显示这个窗口里已经下了多少单;intervalLetter 取 S、M、H、D,对应秒、分、时、天。某条 ORDERS 的 intervalNum 是 10、interval 是 SECOND,对应的头就是 X-MBX-ORDER-COUNT-10S。被拒或失败的下单不保证带这个头,日志里有参考价值的是最后一笔成功下单的响应。想主动查当前计数,可以调 GET /api/v3/rateLimit/order。
ORDERS 里要是有按 DAY 计的一条,它按 UTC 换日,也就是北京时间早上 8 点。2025 年 4 月 7 日的更新日志另加了一条:日窗口的计数超限以后,秒级窗口的计数不再增加。这种情形文档里没有现成的排查例子。我的看法是:最后一笔成功下单响应里秒级那个头离上限还远、新单却一连被拒,就该去看日窗口的计数;真是日窗口满了,短窗口过去也放不了行,只能等换日,或者等已挂出的单成交。
3. 收到 -1015 以后脚本该停多久、下单逻辑改哪几处 #
官方给的做法是在受影响的那个限频窗口结束之前,停止发送订单。挂出去的单只要持续有成交,API 下单就能一直进行下去;单子长时间挂着不成交、又频繁撤了重挂,计数只会一路往上走。
让 AI 改脚本时,把下面几处交代清楚:
- 判断报错用 JSON 里的
code等于 -1015,别去匹配msg的文字。2026 年 11 月 11 日的更新日志把这条英文消息改成了「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写的字符串匹配,碰上新消息就认不出来。 - 拿到 -1015,只停「下新单」这一路,读 429 响应头里
Retry-After的秒数,等够了再恢复;响应头里没有它,就让脚本退出并发通知,不许它自己定一个等待时间。 - 每笔成功下单之后,把所有
X-MBX-ORDER-COUNT-开头的响应头写进日志,和启动时读到的 ORDERS 上限比。离上限还有一段距离就开始放慢,成交到计数更新之间有延迟,等到只剩最后几笔再刹车就晚了。 - 让脚本按窗口统计「下单、撤单、重下」各发生了多少次,把这份统计、上一步的日志和一条完整的 -1015 返回一起贴给 AI,让它指出是哪段逻辑在反复撤了重挂,这些重挂能不能合并或者拉长间隔。贴之前删掉请求头里的
X-MBX-APIKEY和参数里的signature。 - 改完先放到现货测试网跑一段,对照统计看每个窗口新下的单数有没有降下来,再回实盘。测试网的接法见AI 写的币安交易脚本先跑现货测试网:怎么接、和实盘差在哪。
有一种改法看着省事,其实帮不上忙:收到 -1015 就把挂单全部撤掉再重来。撤完马上重挂的每一笔都是新单,计数只会涨得更快,原因见第 1 节的例子。
4. 从返回内容区分 -1015、-1003 和挂单数超限的 -1013 #
超出请求频率限制同样返回 HTTP 429,光看状态码分不出是哪一种,要看 JSON 里的 code 和 msg。下单被拒时最容易混在一起的是这几条:
| 返回 | 数的是什么 | 按什么统计 | 接下来做什么 |
|---|---|---|---|
| -1015 订单太多 | 当前窗口里下出去、还没成交的新单 | 按账户;同一账户下所有 IP、所有 API Key、所有接口共用一份 | 停止下新单,照第 3 节改重挂节奏 |
| -1003 请求过多 | 排队的请求数,或请求消耗的权重 | 按 IP,不按 API Key | 放慢请求,实时数据少用 REST 轮询 |
-1013Filter failure: MAX_NUM_ORDERS | 账户在这个交易对上同时挂着的订单,普通单和止盈止损类的 algo 单一起算 | 按账户、按交易对 | 撤掉不再需要的挂单 |
-1013Filter failure: EXCHANGE_MAX_NUM_ORDERS | 账户在整个交易所挂着的订单 | 按账户 | 同上 |
挂单数上限数的是此刻盘口上还挂着几笔,撤掉一笔就空出一个位置;-1015 数的是窗口里下过几笔、其中多少还没成交。-1013 其余的过滤器怎么查,见币安 API 下单报 -1013 Filter failure 时按过滤器逐个排查。同一段日志里要是 -1003 和 418 也冒了出来,那是 IP 那一侧的限流和封禁,按币安API报429、418:被限流还是IP被封,多久恢复处理。
5. 未成交订单计数按账户统计,隔天的成交也会让它往下减
换 IP 或换一把 API Key 能避开币安 -1015 吗?
换 IP、换 Key 都避不开 -1015。未成交订单计数按账户统计,同一个账户下所有 IP、所有 API Key、所有接口共用一份,几个脚本各用一把 Key 往同一个账户下单,新单都记进这一份计数。想让它降下来,办法是减少撤了重挂的次数,或者让挂出去的单有成交。
隔天才成交的订单能减少当天的未成交订单计数吗?
隔天成交也会往下减:不管订单是哪天下的,现在发生的首次成交都从当前计数里扣。DAY 窗口按 UTC 换日,也就是北京时间早上 8 点。计数减到 0 为止,多出来的成交不会存起来,换日后新下的单照常从 0 开始累加。