目录
文章目录
  1. 1. 撤掉和过期的订单为什么还占着 -1015 的名额
  2. 2. 账户的下单上限去 exchangeInfo 的 ORDERS 项里读
  3. 3. 收到 -1015 以后脚本该停多久、下单逻辑改哪几处
  4. 4. 从返回内容区分 -1015、-1003 和挂单数超限的 -1013
  5. 5. 未成交订单计数按账户统计,隔天的成交也会让它往下减

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

币安现货 API 中文错误代码表里的 -1015 订单太多:下单太多,未成交订单过多,当前限制为每段时间内最多若干个未成交订单,在有成交发生或时间窗口重置之前无法下达新订单,并指向现货未成交订单计数规则
未成交订单过多时,要等有成交发生或时间窗口重置才能再下新单;2026 年 11 月,-1015 名下另有「下单太多」「下单(撤单)太多」两条短提示。

上限从 exchangeInfo 读,剩余额度看下单响应头;挂单类脚本真正要改的,是撤了又重挂的次数。

2026-11-15 发布 PromptDeck 撰 阅读约 8 分钟 约 2,300 字
范围:币安现货 API 下单时返回的 -1015,以及容易和它混淆的 -1003、-1013(挂单数超限)。合约账户的下单报错不在这里。页面里的上限一律用字母代替,具体数值从 exchangeInfo 读。
被拒之后别让脚本原地重试下单:下单请求本身也受通用的请求频率限制。收到 429 之后要退避,反复超限或者收到 429 还不退避,IP 会被自动封禁,返回变成 HTTP 418;屡次触犯的,封禁时长从 2 分钟起逐次拉长,最长 3 天。

下单接口回了 HTTP 429,JSON 里的 code 是 -1015。拦下这笔单的不是请求权重,是币安现货另一套未成交订单计数:当前时间窗口里,这个账户下出去、到现在还一笔没成交的新单已经顶到了上限。

这时候让脚本停止下新单就行,不必忙着撤单腾位置,撤单不会让这个计数往回减。要等几秒,看这条 429 响应头里的 Retry-After;响应头里没带它,就让脚本停下新单并发通知,别自己估一个秒数。窗口过去以后,照第 2 节把账户的下单上限读出来,再照第 3 节改重挂的节奏。

1. 撤掉和过期的订单为什么还占着 -1015 的名额 #

这套计数只数一样东西:某个时间段里新下的、还没成交的订单。每成功下出一笔新单,当前窗口的计数加 1;一笔单第一次成交时,部分成交和全部成交都算,ORDERS 名下每个时间窗口的计数各减 1。撤单不改变计数,订单过期也不改变,FOK 单没成交就过期的,照样留在计数里。

挂单类脚本的麻烦就在这里。行情一动就撤掉旧单、按新价重挂,每重挂一次都是一笔新单,而撤掉的那笔下单时已经记过数。日志里看着盘口上始终只挂着三五笔,窗口里的计数却一直在往上涨。

假设某个 10 秒窗口里发生了这些事:

这个窗口的计数 = 成功下出的新单数 − 第一次成交的订单数 = 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 改脚本时,把下面几处交代清楚:

  1. 判断报错用 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 写的字符串匹配,碰上新消息就认不出来。
  2. 拿到 -1015,只停「下新单」这一路,读 429 响应头里 Retry-After 的秒数,等够了再恢复;响应头里没有它,就让脚本退出并发通知,不许它自己定一个等待时间。
  3. 每笔成功下单之后,把所有 X-MBX-ORDER-COUNT- 开头的响应头写进日志,和启动时读到的 ORDERS 上限比。离上限还有一段距离就开始放慢,成交到计数更新之间有延迟,等到只剩最后几笔再刹车就晚了。
  4. 让脚本按窗口统计「下单、撤单、重下」各发生了多少次,把这份统计、上一步的日志和一条完整的 -1015 返回一起贴给 AI,让它指出是哪段逻辑在反复撤了重挂,这些重挂能不能合并或者拉长间隔。贴之前删掉请求头里的 X-MBX-APIKEY 和参数里的 signature。
  5. 改完先放到现货测试网跑一段,对照统计看每个窗口新下的单数有没有降下来,再回实盘。测试网的接法见AI 写的币安交易脚本先跑现货测试网:怎么接、和实盘差在哪。

有一种改法看着省事,其实帮不上忙:收到 -1015 就把挂单全部撤掉再重来。撤完马上重挂的每一笔都是新单,计数只会涨得更快,原因见第 1 节的例子。

4. 从返回内容区分 -1015、-1003 和挂单数超限的 -1013 #

超出请求频率限制同样返回 HTTP 429,光看状态码分不出是哪一种,要看 JSON 里的 code 和 msg。下单被拒时最容易混在一起的是这几条:

返回数的是什么按什么统计接下来做什么
-1015 订单太多当前窗口里下出去、还没成交的新单按账户;同一账户下所有 IP、所有 API Key、所有接口共用一份停止下新单,照第 3 节改重挂节奏
-1003 请求过多排队的请求数,或请求消耗的权重按 IP,不按 API Key放慢请求,实时数据少用 REST 轮询
-1013
Filter failure: MAX_NUM_ORDERS
账户在这个交易对上同时挂着的订单,普通单和止盈止损类的 algo 单一起算按账户、按交易对撤掉不再需要的挂单
-1013
Filter 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 开始累加。

风险与链接说明:本页依据币安开发者文档的现货未成交订单计数规则、LIMITS 说明、现货错误代码页和更新日志整理,计数规则和报错消息会随文档更新而变化。不构成投资建议;让脚本在实盘自动下单可能造成资金损失,运行前请确认你所在地区能否使用。 本站部分评测页含币安推介链接,经这些链接注册,本站可能获得佣金;本页正文没有推介链接。 完整披露 →