更新日志
最近更新: 2026-04-06
2026-04-06
- 补充了有关 价格区间执行规则 中规则执行的更多信息。
2026-04-02
关于 2026-03-27 公告中针对部分端点请求权重计算的说明:
对于被修改的订单,只有当订单因该次修改过期时,请求权重才会变为 0。 未导致订单过期的成功请求,仍会按文档中说明的方法消耗权重值。 失败的请求,同样会按文档中说明的计算方法消耗权重值。
此规则适用于以下端点和方法:
- REST API:
PUT /api/v3/order/amend/keepPriority - WebSocket API:
order.amend.keepPriority
2026-03-30
- 更新了价格区间执行规则,以说明订单的执行价格限制。
2026-03-27
以下内容将于2026年4月2日大约07:00 UTC生效。
-
RAW_REQUESTS速率限制提升至每5分钟300,000次。 -
以下端点和方法的请求权重在请求成功时变为0。请求失败仍会按照文档中规定的方法计算权重。
仅有成功调用这些端点的IP将永远不会受到REQUEST_WEIGHT速率限制。- REST API
POST /api/v3/orderPOST /api/v3/sor/orderDELETE /api/v3/orderDELETE /api/v3/openOrdersPOST /api/v3/order/cancelReplacePOST /api/v3/order/ocoPOST /api/v3/orderList/ocoPOST /api/v3/orderList/otoPOST /api/v3/orderList/otocoPOST /api/v3/orderList/opoPOST /api/v3/orderList/opocoDELETE /api/v3/orderListPUT /api/v3/order/amend/keepPriority(请参见 2026-04-02 的更新)
- WebSocket API
order.placesor.order.placeorder.cancelopenOrders.cancelAllorder.cancelReplaceorderList.placeorderList.place.ocoorderList.place.otoorderList.place.otocoorderList.place.opoorderList.place.opocoorderList.cancelorder.amend.keepPriority(请参见 2026-04-02 的更新)
- REST API
-
STP TRANSFER 模式 将在 2026-04-02 07:00 UTC 生 效
2026-03-13
- 在价格区间执行规则 中新增了外部参考价格计算方法。
2026-03-11
通知: FIX TLS 连接更新将于 2026-06-08,从 03:00 UTC 开始,预计耗时约 1 小时完成。
请注意及时处理:
- 在更新期间,现有的 FIX 连接可能会间歇性断开。为确保更新后能够成功重新连接和建立新连接,请在我们更新之前确认您的客户端在 TLS 握手过程中发送了 SNI(服务器名称指示)并且对目标主机名进行了证书验证。
- 未发送 SNI 的客户端可能会在更新期间或之后收到证书错误的消息,导致 TLS 握手或主机名验证失败。这种情况可能发生在某些未配置 SNI 的 Node.js 客户端上。
- 请查阅 FIX API 文档 以获取完整信息。
2026-03-10
说明了关于价格区间执行规则 中参考价格的计算方法。
2026-03-09
注意: 本部分的变更将逐步推出,预计大约需要三周时间完成。
新功能
- 价格区间执行规则)
- 新增接口/方法
- REST API:
GET /api/v3/executionRulesGET /api/v3/referencePriceGET /api/v3/referencePrice/calculation
- WebSocket API:
executionRulesreferencePricereferencePrice.calculation
- REST API:
- 新增 JSON 数据流:
<symbol>@referencePrice
- 新增接口/方法
- REST 和 WebSocket API SBE schema 3:3
- 当前的 schema 3:2 spot_3_2.xml 已被废止,将根据我们的 schema 废止政策在6个月内停止使用。
- schema 3:3 的变更内容:
- 新消息
ExecutionRulesResponse - 新消息
PriceRangeExecutionRule(嵌入于ExecutionRulesResponse中) - 新消息
ReferencePriceResponse - 新消息
ReferencePriceCalculationResponse - 新枚举
executionRuleType - 新枚举
expiryReason - 新枚举
calculationType - 在
NewOrderResultResponse、NewOrderFullResponse、NewOrderListResultResponse和NewOrderListFullResponse中新增字段expiryReason - 在
ExecutionReportEvent中新增字段expiryReason - 新消息
ServerShutdownEvent(仅限 WebSocket API)
- 新消息
- FIX SBE schema 1:1
- 该 schema 将用于 FIX 订单接入、FIX Drop Copy 和 FIX 市场数据流。
- 当前的 FIX schema 1:0 spot-fixsbe-1_0.xml 已被废止,将根据我们的 schema 废止政策在6个月内停用。
- schema 1:1 的变更内容:
- 新枚举
expiryReason - 在
ExecutionReport中新增字段ExpiryReason
- 新枚举
FIX API
- 在 ExecutionReport
<T>消息中可选新增字段 ExpiryReason<25056>。- 更新了用于 FIX 市场数据流和 FIX 订单接入的 QuickFIX Schema。
WebSocket API
- 新增
serverShutdown事件。
未来的更新
- 以下接口已在 2019-11-13 废止,将于 2026-03-25 停用:
GET /api/v1/pingGET /api/v1/timePOST /api/v1/userDataStreamPUT /api/v1/userDataStreamGET /api/v1/ticker/bookTickerGET /api/v1/ticker/priceGET /api/v1/klinesGET /api/v1/historicalTradesGET /api/v1/depthGET /api/v1/aggTradesGET /api/v1/ticker/24hr
- 以下接口将于 2026-03-25 停用:
GET /api/v1/userDataStreamDELETE /api/v1/userDataStreamGET /api/v1/trades
- 以下变更将于 2026-03-26 约 07:00 UTC 生效
- 下单及订单列表下单接口的响应将根据
newOrderRespAck的值显示订单过期原因:- 如果
newOrderRespType=ACK,则不显示过期原因。 - 如果
newOrderRespType=RESULT或newOrderRespType=FULL模式,如果出现订单过期,则在字段expiryReason中显示过期原因。- 影响的接口/方法包括:
- REST API
POST /api/v3/orderPOST /api/v3/sor/orderPOST /api/v3/order/cancelReplacePOST /api/v3/order/ocoPOST /api/v3/orderList/ocoPOST /api/v3/orderList/otoPOST /api/v3/orderList/otocoPOST /api/v3/orderList/opoPOST /api/v3/orderList/opoco
- WebSocket API
order.placesor.order.placeorder.cancelReplaceorderList.placeorderList.place.ocoorderList.place.otoorderList.place.otocoorderList.place.opoorderList.place.opoco
- REST API
- 影响的接口/方法包括:
- 如果
- 在用户数据流中,
executionReport事件新增可选字段eR,如果出现订单过期,则用于显示订单过期原因。
- 下单及订单列表下单接口的响应将根据
2026-02-24
- 所有交易对的 ICEBERG_PARTS 将于 2026-03-12 07:00 UTC 提升至 100。
- 根据2025-12-02的公告,
!ticker@arr将于 2026-03-24 07:00 UTC 停用。
2026-02-12
REST 和 WebSocket API:
- 注意:根据我们的 SBE 政策,在被废止 6 个月后, SBE 3:0 模式将于 2026 年 02 月 19 日被停用。
- 面向生产的 SBE 生命周期 已基于本次更改进行了更新。
2026-02-09
- 在 FIX SBE 文档 中阐明了有关指数字 段的要求
2026-02-02
- 记录了 FIX Drop Copy 会话 数据存在 1 秒的延迟。自 FIX API 推出以来,该延迟一直存在。
2026-01-29
2026-01-27
通知:以下变更将于 2026-02-11 07:00 UTC 生效:
- 所有交易对的 ICEBERG_PARTS 将增加到 50。
2026-01-26
- 在
userDataStream.subscribe.signature中添加了字段recvWindow的说明。
2026-01-21
根据 2025-10-24 的公告,以下端点和方法将从 2026-02-20 07:00 UTC 起不再可用。
REST API
POST /api/v3/userDataStreamPUT /api/v3/userDataStreamDELETE /api/v3/userDataStream
WebSocket API
userDataStream.startuserDataStream.pinguserDataStream.stop
2025-12-18
- FIX SBE 文档 已更新。
- 澄清了用户数据流文档中关于
eventStreamTerminated的说明 - 资产
这是测试币和456以及交易对这是测试币456已被添加到 现货测试网 以供用户测试含有 Unicode 交易对的端点/方法。 预知详情,请参考 现货测试网的相关更新日志。
2025-12-17
时效性通知
- 以下有关于REST API变更将在 2026-01-15 07:OO UTC 发生:
调用需要签名的接口时,请在计算签名之前对 payload 进行百分比编码(percent-encode)。不符合此顺序的请求将被拒绝,并返回错误代码-1022 签名不正确。请检查并相应地更新您代码中的签名逻辑部分。这项功能现已在 SPOT Testnet 上启用。
REST API
- 更新了 REST API 文档中有关于 签名请求示例 的部分。
WebSocket API
- 更新了 WebSocket API 文档中有关于 签名请求示例 的部分。
2025-12-15
关于 UTF-8 编码的说明:
- 在 FIX API、REST API 和 WebSocket API 中,如果您的请求包含非 ASCII 字符的交易对名称,那么响应中可能包含以 UTF-8 编码的非 ASCII 字符。
- 在 REST 和 WebSocket API 中,即使请求本身不包含非 ASCII 字符,某些端点/方法也可能返回包含以 UTF-8 编码的非 ASCII 字符的资产和/或交易对名称。
- 在 WebSocket 数据流 中,如果您的请求包含非 ASCII 字符的交易对名称,那么数据流事件中可能包含以 UTF-8 编码的非 ASCII 字符。
- 在 WebSocket 数据流中,全市场所有 Symbol 的精简 Ticker 和 全市场滚动窗口统计 事件可能包含以 UTF-8 编码的非 ASCII 字符。
- 在 SBE 市场数据流 中,如果您的请求包含包含非 ASCII 字符的交易对名称,那么数据流事件中可能包含以 UTF-8 编码的非 ASCII 字符。
- 如果您持有或交易任何名称包含非 ASCII 字符的资产或交易对,那么 WebSocket 账户接口 中可能包含以 UTF-8 编码的非 ASCII 字符。
- 为了与币安 API 完全兼容,请务必确保您的代码能够处理 UTF-8 编码的字符串。
2025-12-09
- FIX SBE Schema 已更新,会在
MarketDataSnapshot中使用smallGroupSize16Encoding。并在增量单个交易对订单簿数据流/深度数据流的MDEntrySize的字段中使用presence="optional"。 - 更新了关于 FIX 与 FIX SBE 的文档说明
- 在 REST 和 WebSocket API 文档中新增说明:请避免在请求中使用 SQL 关键字,因为这可能会触发 Web 应用防火墙(WAF)规则导致安全拦截。详情请参见 https://www.binance.com/zh-CN/support/faq/detail/360004492232 。
2025-12-02
注意: 本节中的变更将逐步推出,预计大约需要两周时间完成。
常规更改
- 参数
symbol和symbols现在支持以 UTF-8 编码的 Unicode 值。 - 根据 2025-11-14 的公告,所有与
!ticker@arr相关的内容已经在文档被移除。- 该功能将在未来弃用公告发布前继续可用。
- 请改用
<symbol>@ticker或!miniTicker@arr。
FIX API
- 现在 FIX 消息中可以接受以 UTF-8 编码的 Unicode 值。仅允许以下标签使用:
Currency (15)MiscFeeCurr (138)Symbol (55)SecondarySymbol (25019)CounterSymbol (25028)SecurityDesc (107)
- 当 Unicode 出现在非上述标签的值中时,FIX API 会在拒绝消息
<3>中返回RefTagID (371)标签,指明具体哪个标签不允许包含 Unicode。 - NewOrderList
<E>可以接受没有TriggerPrice (1102)的TriggerPriceDirection (1109)。
WebSocket 数据流
- WebSocket 市场数据流支持 URL 编码的 URL。
注意:以下变更预计于 2025-12-18 07:00 UTC 左右生效:
- ICEBERG_PARTS 将对所有交易对提升至 25。
- FIX SBE 支持 将上线。
- 一个订单支付另一个订单(OPO) 将在所有交易对上线。
opoAllowed将开始出现 在Exchange Information请求中,指示每个交易对是否支持一个订单支付另一个订单(OPO)。- REST API:
GET /api/v3/exchangeInfo - WebSocket API:
exchangeInfo
- REST API:
- OPO 新请求:
- REST API:
POST /api/v3/orderList/opoPOST /api/v3/orderList/opoco
- WebSocket API:
orderList.place.opoorderList.place.opoco
- FIX API:
- NewOrderList
<E>新增字段OPO (25046)。请更新至最新 QuickFIX 模式以支持 OPO。
- NewOrderList
- REST API:
- 新增 STP 模式
TRANSFER。STPTRANSFER启用的具体日期尚未确定。 - SBE:新增 schema 3:2 版本 (spot_3_2.xml)。
- 当前 schema 3:1 (spot_3_1.xml) 已被弃用,将根据我们的 schema 弃用政策在 6 个月后停用。
- 3:2 版本变更:
- 为
selfTradePreventionMode和allowedSelfTradePreventionModes新增枚举值TRANSFER。 - 所有低于 3:1 的 schema 无法返回包含 STP 模式
TRANSFER的响应(例如 Exchange Information、下单、撤单或订单状态查询)。
当响应无法用请求的 schema 表示时,将返回错误。
- 为
- FIX API 变更:
LastFragment (893)被弃用。- 这意味着 MarketIncrementalRefresh
<X>消息将不再分片,可能包含超过 10,000 条目。 - 文档已更 新以反映此变更。
- 这意味着 MarketIncrementalRefresh
- ListStatus
<N>将不再发送可选的symbol字段。- 适用于 FIX 订单接入和 FIX Drop Copy。
- 文档已更新以反映此变更。
2025-11-14
- 全市场所有交易对的完整Ticker(
!ticker@arr)已被弃用;这意味着该接口将在后续从文档和系统中移除,具体时间另行通知。 - 请改用
<symbol>@ticker或!miniTicker@arr。
2025-11-12
- 关于如何正确管理本地订单簿的步骤已被修正。
2025-11-11
SBE 市场数据流
- 从 2025 年 11 月 26 日 07:00 UTC 起,
<symbol>@depth和<symbol>@depth20数据流的更新速度将变为 50 毫秒。
2025-11-10
- 除了更新日志之外,所有文档中的“最近更新”日期将被移除。
- 今后,更新日志将作为所有文档变更时间的唯一参考来源。
2025-10-28
注意:以下变更将于 2025 年 10 月 28 日 04:00 (UTC) 推出,可能需要几个小时才能完成部署。
- 可选参数
symbolStatus已添加到以下端点:- REST API
GET /api/v3/depthGET /api/v3/ticker/priceGET /api/v3/ticker/bookTickerGET /api/v3/ticker/24hrGET /api/v3/ticker/tradingDayGET /api/v3/ticker
- WebSocket API
depthticker.priceticker.bookticker.24hrticker.tradingDayticker
- REST API
- 当提供参数
symbolStatus=<STATUS>时,只有交易状态与指定的STATUS相匹配的交易对才会包含在响应中:- 如果使用
symbol=<SYMBOL>参数指定单个交易对,但是这个交易对的状态与指定的STATUS不匹配时,端点将返回错误代码-1220 SYMBOL_DOES_NOT_MATCH_STATUS。 - 如果使用
symbols=[...]参数指定了多个交易对,那么响应将是一个数组。该数组中将不会包括交易状态与STATUS不匹配的交易对。当 symbols 参数中所指定的交易对中没有任何一个交易对的状态与STATUS相匹配时,响应将为一个空数组。 - 对于
symbol和symbols参数为可选参数的端点,省略这些参数将被视为在symbols=[...]参数中指定了所有交易对。有关symbolStatus=<STATUS>的行为,请参阅上一行。
- 如果使用
2025-10-24
SBE
- SBE:schema 3:1(spot_3_1.xml)已更新,支持保证金交易 的listenToken 订阅方法。
REST 和 WebSocket API
根据 2025-04-07 的公告,所有关于在 wss://stream.binance.com 上使用 listenKey 的文档已被移除。请参阅以下请求和方法列表以获取详细信息。
该功能将在未来发布停用公告之前继续可用。
特此提醒您: 您应该通过订阅 在 WebSocket API 内的账户信息流 来获得用户账户更新。这样可以提供更好的性能(更低的延迟)。
请参阅下方请求和方法列表来了解更多详情。
这些功能将持续可用,直至另行发布停用公告。
-
REST API
POST /api/v3/userDataStreamPUT /api/v3/userDataStreamDELETE /api/v3/userDataStream
-
WebSocket API
userDataStream.startuserDataStream.pinguserDataStream.stop
2025-10-21
REST 和 WebSocket API:
- 注意:根据我们的 SBE 政策,在被废止 6 个月后, SBE 2:1 模式将于 2025 年 10 月 24 日被禁用。
- 面向生产的 SBE 生命周期 已基于本次更改进行了更新。
2025-10-08
- 更新了用于 FIX 市场数据的 QuickFIX Schema:
- 更新了
RecvWindow(25000),以便对在 2025-08-12 公布的微秒级进行支持。 - 更新了
InstrumentList消息:- 新增字段:
StartPriceRange、EndPriceRange。 - 以下字段改为可选:
MinTradeVol、MaxTradeVol、MinQtyIncrement、MarketMinTradeVol、MarketMaxTradeVol、MarketMinQtyIncrement、MinPriceIncrement。
- 新增字段:
- InstrumentList
<y>的变更属于破坏性变更,预计将于 2025-10-23 07:00 UTC 左右发布。请在此之前更新到新的模式。 - 在SPOT 测试网 上已经启用了这个重大更改。
- 更新了
2025-09-29
注意:以下变更将于 2025 年 9 月 29 日 10:00 (UTC) 推出,可能需要几个小时才能完成部署。
- 新增一个端点,用于检索与指定交易品种的账户相关的过滤器列表。这是唯一一个目前会显示账户是否应用了
MAX_ASSET过滤器的端点。- REST API:
GET /api/v3/myFilters - WebSocket API:
myFilters
- REST API:
- 对 SBE: schema 3:1 (spot_3_1.xml) 中的部分注释进行了添加、修改和删除。虽然
3:1用户无需更新到此版本的模式,但我们建议您进行更新以保持一致性。 - 新增了有关过滤器
MAX_ASSET的文档。
2025-09-18
- 更新了文档中有关
recvWindow的部分, 用以体现在 2025-08-12 发表的微秒级支持。