更新日志

最近更新： 2025-06-04

2025-06-04

REST 和 WebSocket API：

注意：根据我们的 SBE 政策，在被废止 6 个月后， SBE 2：0 模式将于 2025 年 06 月 12 日被禁用。
面向生产的 SBE 生命周期已基于本次更改进行了更新。

2025-05-28

在 “API 基本信息” 下，记录每个 API 的超时值和错误：
- FIX
- REST
- WebSocket

2025-05-22

注意：以下变更将于 2025 年 6 月 6 日 7:00 (UTC) 生效。

将通过一项额外的检查，对 FIX、REST 和 WebSocket API 上先前关于recvWindow 的行为进行强化。
- 让我们回顾一下现有行为：
  - 如果在接收请求时， timestamp 大于 serverTime + 1 秒，则请求会被拒绝。此检查被拒绝的话，将会增加消息限制（FIX API）和 IP 限制（REST 和 WebSocket API），但不会增加未成交订单计数（所有 API 的下单端点）。
  - 如果在接收请求时， timestamp 和 serverTime 之间的差值大于 recvWindow，则请求被拒绝。此检查被拒绝的话，将会增加消息限制（FIX API）和 IP 限制（REST 和 WebSocket API），但不会增加未成交订单计数（所有 API 的下单端点）。
- 附加检查：
  - 在请求转发到撮合引擎之前，如果 timestamp 与当前 serverTime 之间的差值大于 recvWindow，则拒绝该请求。此检查被拒绝的话，将会增加消息限制（FIX API）、IP 限制（REST 和 WebSocket API）以及未成交订单计数（所有 API 的下单端点）。
- 已更新 Timing 安全性文档，以反映新增的附加检查。
修复了 FIX Market Data 消息 InstrumentList <y> 中的一个错误。之前，NoRelatedSym(146) 的值可能会不正确。

2025-04-29

目前需要 Ed25519 API 密钥才能使用的功能将很快会对 HMAC 和 RSA 密钥开放。
- 例如，在 listenKeys 被移除前，您可以使用任何 API 密钥类型在 WebSocket API 中订阅账户数据流。
- 我们仍然鼓励用户迁移到 Ed25519 API 密钥，因为它们在币安现货交易中更安全、性能更佳。
- 更多详情即将公布，敬请关注，不要错过。

2025-04-25

以下请求权重将从 1 增加到 4：
- REST API: PUT /api/v3/order/amend/keepPriority
- WebSocket API: order.amend.keepPriority
- REST 和 WebSocket API 的文档均已更新，以反映即将发生的更改。
澄清了 FIX-API 中的 SEQNUM 是一个累计到最大值后将会归 0，然后重新开始计数的 32 位无符号整数。自 FIX-API 诞生以来，它一直是 SEQNUM 数据类型。

2025-04-21

关于保留优先级的修改订单请求 (Order Amend Keep Priority) 和 STP 方式 DECREMENT（递减）发布的说明：

于 2025-05-07 07:00 UTC
- 所有交易对将启用 ”保留优先级的修改订单请求“ 功能。
- 所有交易对将允许 “STP 递减”。
自2025年4月24日 07:00 UTC起，amendAllowed 字段将在交易所信息请求中可见，但该功能尚未启用。
SPOT 测试网在所有交易对上都启用了这两项功能。

2025-04-08

通知: 本节中的更改将逐步推出,需要一周时间才能完成.

新的错误代码 -2039，如果查询同时具有 orderId 和 origClientOrderId 的订单，并且未找到具有此组合的订单.
- 受影响的请求:
  - REST API:GET /api/v3/order
  - WebSocket API:order.status
错误代码文档在错误代码 -1034 中更新了新的错误消息, 当超过 FIX 连接速率限制时会出现。(更多细节参看昨天的更新)

2025-04-07

常规更改

通知: 本节中的更改将逐步推出,需要一周时间才能完成.

在2025 年 1 月 16 日，FIX Market Data 会话的连接限制从 5 个增加到了 100 个。这个改变没有在之前的更改日志中被明示。
新的错误代码 -2038，将在保留优先权的修改订单请求失败时出现。
错误代码 -1034 有了新消息。
如果未成交订单计数超过了在 intervalNum:DAY 里定义的限制, 那么 intervalNum:SECOND 下的未成交订单计数将不再递增。
以前，无论提供的参数如何，myTrades 请求的权重都是 20。现在，如果您提供 orderId ，请求的权重将为 5。
- REST API：GET /api/v3/myTrades
- WebSocket API：myTrades
查询和删除订单的变化：
- 现在，当 orderId 和 origClientOrderId 都不存在时，请求将被拒绝，并显示 -1102 而不是 -1128。
- 受影响的请求：
  - REST API：
    - GET /api/v3/order
    - DELETE /api/v3/order
  - WebSocket API：
    - order.status
    - order.cancel
  - FIX API：
    - OrderCancelRequest <F>

FIX API

通知: 以下变更将于 2025 年 4 月 21 日期间发生。

FIX API 会验证 EncryptMethod(98) 在登录 Logon <A> 时是否为 0。
FIX 订单接入会话的每个账户有 10 个并发 TCP 连接的限制。
现在强制实施连接速率限制.请注意，这些限制是针对账户和 IP 地址独立检查的。
- FIX 订单接入会话：在 30 秒内 15 次连接尝试的限制
- FIX Drop Copy 会话：在 30 秒内 15 次连接尝试的限制。
- FIX Market Data 会话：在 300 秒内 300 次连接尝试的限制。
News <B> 在 Headline 字段中包括了一个倒计时消息。
- 在本次更新完成后：当服务器进入维护状态时，将向客户端每隔 10 秒发送一条 News 消息，并持续 10 分钟。在10分钟过后，客户端将被注销，其会话将被关闭。
OrderCancelRequest <F> 和 OrderCancelRequestAndNewOrderSingle <XCN> 现在允许使用 orderId 和 clientOrderId。
FIX 订单接入会话的 QuickFix 模式已被更新，将支持保留优先级的修改订单请求（Order Amend Keep Priority）和新的 STP 方式 DECREMENT。

User Data Streams

我们将弃用此功能：通过使用 listenKey 来访问 wss://stream.binance.com:9443 以监听账户信息的。
- 以后但不是当前，此功将被能从我们的系统中删除。
您应该通过订阅在 WebSocket API 内的账户信息流来获得用户账户更新。
- 这个方式会提供稍好的性能 （较低的延迟）。
- 必须使用 Ed25519 API 密钥
在未来的更新中，将删除有关账户数据流的 WebSocket 基本访问地址的信息。
在未来的更新中，以下请求将被从文档中删除：
- POST /api/v3/userDataStream
- PUT /api/v3/userDataStream
- DELETE /api/v3/userDataStream
- userDataStream.start
- userDataStream.ping
- userDataStream.stop
WebSocket 账户接口文档将保留可以接收的有效负载，以供您参考。

将会发生的更改

以下变更将于2025 年 4 月 24 日 07:00 UTC发生：

~~保留优先级的修改订单请求（Order Amend Keep Priority）将可以使用。 (请注意，必须在相应交易对上启用该功能后才能使用。)~~
- 新字段 amendAllowed 会出现在 Exchange Information 响应中。
  - 2025-04-21 更新："保留优先级的修改订单请求" 的具体启用日期尚未确定
  - REST API： GET /api/v3/exchangeInfo
  - WebSocket API： exchangeInfo
- FIX API：新的 Order Entry 消息 OrderAmendKeepPriorityRequest 和 OrderAmendReject
- REST API：PUT /api/v3/order/amend/keepPriority
- WebSocket API： order.amend.keepPriority
~~如果已在交易对上作了相应配置，那么 STP 方式 DECREMENT （递减）将在 Exchange Information 中可见。~~
- 2025-04-21 更新："STP 方式 DECREMENT" 的具体启用日期尚未确定。
- 通过不仅仅使挂单或吃单过期,或无条件地让两种订单都过期，STP 递减会减少两种订单的可用数量，并将通过阻止匹配的数量来增加两种订单的 prevented quantity 值。
- 这将使可用数量较少的订单过期，因为(filled quantity + prevented quantity)等于 order quantity。如果两个订单的可用数量相等，那么两个订单都将过期。这种情况被称为“递减”，因为可用数量减少了。
使用 orderId 和 origClientOrderId/cancelOrigClientOrderId 来查询和/或取消订单：
- 以前，当两个参数都提供时，在各个端点的上行为并不一致。
- 以后，当同时提供两个参数时，系统首先将会使用订单的 orderId 来搜索订单。如果订单被找到， origClientOrderId/cancelOrigClientOrderId 的值将会被用来验证被找到的订单。如果两个检测条件都通过，那么请求成功。如果两个条件都不满足，则请求将被拒绝。
- 受影响的请求：
  - REST API：
    - GET /api/v3/order
    - DELETE /api/v3/order
    - POST /api/v3/order/cancelReplace
  - WebSocket API：
    - order.status
    - order.cancel
    - order.cancelReplace
  - FIX API：
    - OrderCancelRequest <F>
    - OrderCancelRequestAndNewOrderSingle <XCN>
使用 listOrderId 和 listClientOrderId 来取消订单:
- 以前，当两个参数都提供时，在各个端点的上行为并不一致。
- 以后，当同时提供两个参数时，系统首先将会使用 listOrderId 来搜索订单列表。如果找到相应的订单列表，listClientOrderId 将会被用来验证被找到的订单列表。如果两个条件都不满足，请求将被拒绝。
- 受影响的请求
  - REST API
    - DELETE /api/v3/orderList
  - WebSocket API
    - orderList.cancel
SBE：新模式 3:0 (spot_3_0.xml) 将可以使用。
- 现行模式 2:1 (spot_2_1.xml) 将会被废止并根据我们的废止政策，在6个月内停止使用。
- 请注意：在新模式被发布前，尝试使用模式 3:0 将导致错误。
- 3:0 中的更改：
  - 将会支持保留优先级的修改订单（Order Amend Keep Priority）请求:
    - 在 ExchangeInfoResponse 中添加了 amendAllowed 字段。
    - 新消息 OrderAmendmentsResponse 和 OrderAmendKeepPriorityResponse。
  - 所有的枚举类型都有了新变量：NON_REPRESENTABLE。这将用于将来，对新的枚举值进行编码。新模式的枚举类型可能会与 3:0 不兼容。
  - 新增针对 selfTradePreventionMode 和 allowedSelfTradePreventionModes 的新枚举变量 DECREMENT。
  - symbolStatus 枚举下的值 AUCTION_MATCH， PRE_TRADING 以及 POST_TRADING 已被删除。
  - 字段 usedSor, orderCapacity， workingFloor，preventedQuantity 以及 matchType 将不再是可选的参数。
  - 更改了 ExecutionReportEvent：现在，字段 orderCreationTime 是可选的。
- 通过 WebSocket API 来使用被废止的 2:1 版本的模式来侦听账户数据流：
  - ListStatusEvent 的字段 listStatusType 在 Updated 时，会呈现为 ExecStarted。升级到模式 3:0 来获取正确的值。
  - ExecutionReportEvent 的字段 selfTradePreventionMode 在 Decrement 时，会呈现为 None。这将只在 executionType 为 TradePrevention 时发生。
  - ExecutionReportEvent 的字段 orderCreationTime 在没有值时将呈现为 -1。
- 所有低于 3:0 版本的模式不会支持对保留优先级修改订单请求（Order Amend Keep Priority）的响应，以及任何可能包含 STP 方式 DECREMENT 的响应（比如，Exchange Information，下单，取消订单或查询您的订单状态）。当响应无法用被指定的模式来表达时，系统将返回错误。

2025-04-03

关注 SPOT 测试网的最新更新,将 WebSocket API 中的 URL 更新为 [SPOT Testnet] 的最新 URL(https://testnet.binance.vision/).

2025-03-31

添加了对取消订单性能的说明.

2025-03-10

注意：以下变更将于 2025 年 3 月 13 日 09:00 UTC 发生。
- FIX Drop Copy 会话的限制将会为每分钟 60 条消息。
- FIX Market Data 会话的限制将会为每分钟 2000 条消息。
- FIX API 文档已更新，以反映即将发生的更改。
SBE 市场数据流将于 2025 年 3 月 18 日 07:00 UTC 上线。 这些流会提供较小的有效负载，将为部分对延迟比较敏感的市场数据连接提供更快的响应时间。
- 以 SBE 格式提供的数据流：
- 实时：逐笔交易
- 实时：最优挂单信息
  - 每 100 毫秒：增量深度信息
- 每 100 毫秒：有限档深度信息
- 有关更多信息，请参阅 SBE 市场数据连流。

2025-03-05

注意：以下变更将于 2025 年 3 月 10 日 12:00 UTC 发生。
以下请求权重将从 2 增加到 4：
- REST API： GET /api/v3/aggTrade
- WebSocket API： trades.aggregate
REST 和 WebSocket API 的文档均已更新，以反映即将发生的更改。

2025-02-12

**注意：这些更改将于 2025 年 2 月 26 日 05：00 UTC 生效。请确保在此之前您已下载最新的模式。
AggressorSide （2446) 将在 FIX 市场数据流中提供。QuickFIX 模式 file 也已更新。

2024-01-28

注意: 该变更会在2025年2月3日到2025年2月14日之间逐步推出。

以下变更将会同时应用于WebSocket 市场数据流，WebSocket 账户接口和 WebSocket API:
- WebSocket 服务将会每20秒发送发送 PING 消息而不是每3分钟。
- PONG 消息的延迟将会是每1分钟而不是每10分钟。
- 相关服务的更改所对应的文档都已经更新。

2025-01-09

FIX 市场数据将在 January 16, 05:00 UTC 提供。FIX API 文档已更新有关此功能。
请参阅此 [链接]（https://github.com/binance/binance-spot-api-docs/blob/master/fix/schemas/spot-fix-md.xml）以获取 FIX市场数据的 QuickFIX 模式。

2024-12-17

常规更改：

系统现在在所有相关时间和/或时间戳的字段中支持微秒。微秒支持是 opt-in，默认情况下，请求和响应仍然使用毫秒。文档中的示例也在可预见的将来使用毫秒。

WebSocket Streams

可以在连接 URL 中使用新的可选参数 timeUnit 来选择时间单位。
- 例如：/stream？streams=btcusdt@trade&timeUnit=millisecond
- 支持的值为：
  - MILLISECOND
  - millisecond
  - MICROSECOND
  - microsecond
- 如果未选择时间单位，则默认使用毫秒。

REST API

可以在请求中发送新的可选报文头 X-MBX-TIME-UNIT 来选择时间单位。
- 支持的值：
  - MILLISECOND
  - millisecond
  - MICROSECOND
  - microsecond
- 时间单位会影响 JSON 响应中的时间戳字段（例如，time、transactTime）。
  - 无论时间单位如何，SBE 响应都将继续以微秒为单位。
- 如果未选择时间单位，则默认使用毫秒。
时间戳参数（例如 'startTime'、'endTime'、'timestamp）' 现在可以以毫秒或微秒为单位传递。

WebSocket API

可以在连接 URL 中使用新的可选参数 timeUnit 来选择时间单位。
- 支持的值：
  - MILLISECOND
  - millisecond
  - MICROSECOND
  - microsecond
- 时间单位会影响 JSON 响应中的时间戳字段（例如，time、transactTime）。
  - 无论时间单位如何，SBE 响应都将继续以微秒为单位。
- 如果未选择时间单位，则默认使用毫秒。
时间戳参数（例如 startTime、endTime、timestamp）现在可以以毫秒或微秒为单位传递。

User Data Streams

可以在连接 URL 中使用新的可选参数 timeUnit 来选择时间单位。
- 支持的值
  - MILLISECOND
  - MICROSECOND
  - microsecond
  - millisecond

2024-12-09

注意： 以下的变更会从2024 年 12 月 12日开始推出，可能需要大约一周的时间才能完成。

常规更改：

现在会拒绝距离过去或未来太远的时间戳参数值。
时间戳数值在 2017 年 1 月 1 日之前（小于 1483228800000）
时间戳数值超过当前时间 10 秒以后（例如，如果当前时间为 1729745280000, 那么使用 1729745290000 或更大是错误的）
如果 startTime 和/或 endTime 的值超出范围，数值会被调整至正确的范围。
已将 quote order quantity （origQuoteOrderQty）字段添加到原先没有该字段的响应中。请注意，对于下单相关的接口，该字段将仅针对 newOrderRespType 设置为 RESULT 或 FULL 的请求显示。

请参阅以下列表，以便了解因带有： origQuoteOrderQty 而受影响的请求：

服务	请求
REST	`POST /api/v3/order`
	`POST /api/v3/sor/order`
	`POST /api/v3/order/oco`
	`POST /api/v3/orderList/oco`
	`POST /api/v3/orderList/oto`
	`POST /api/v3/orderList/otoco`
	`DELETE /api/v3/order`
	`DELETE /api/v3/orderList`
	`POST /api/v3/order/cancelReplace`
WebSocket API	`order.place`
	`sor.order.place`
	`orderList.place`
	`orderList.place.oco`
	`orderList.place.oto`
	`orderList.place.otoco`
	`order.cancel`
	`orderList.cancel`
	`order.cancelReplace`

SBE

已发布新模式 2:1 spot_2_1.xml。当前模式 2:0 spot_2_0.xml 将被弃用。根据我们的模式弃用政策，当前模式 2:0 会将在 6个月内从 API 中停用。
模式 2：1 是模式 2：0 的向后兼容更新版本。当您请求模式 2：0 或 2：1 时，您将始终收到 2：1 格式的有效载荷。
SBE 模式 2：1 中的更改：
- 下单/取消订单响应中的新字段 origQuoteOrderQty （注意：使用 2：0 模式生成的解码器将忽略此字段）：
  - NewOrderResultResponse
  - NewOrderFullResponse
  - CancelOrderResponse
  - NewOrderListResultResponse
  - NewOrderListFullResponse
  - CancelOrderListResponse
- 仅限 WebSocket API：会话状态响应中的新字段 userDataStream：
  - WebSocketSessionLogonResponse
  - WebSocketSessionStatusResponse
  - WebSocketSessionLogoutResponse
- 仅限 WebSocket API：在 User Data Stream 中会支持的新消息：
  - UserDataStreamSubscribeResponse
  - UserDataStreamUnsubscribeResponse
  - BalanceUpdateEvent
  - EventStreamTerminatedEvent
  - ExecutionReportEvent
  - ExternalLockUpdateEvent
  - ListStatusEvent
  - OutboundAccountPositionEvent

WebSocket API

您现在可以通过 WebSocket API 连接订阅账户数据流事件。
- 请注意：此功能仅适用于使用 Ed25519 API 密钥的用户。
- 请注意：如果您要订阅使用 SBE 格式的账户数据流，则需使用新的 SBE 模式 2:1。
新请求：
- userDataStream.subscribe
- userDataStream.unsubscribe
对于 session.logon、 session.status 和 session.logout 的更改。
- 添加了一个新字段 userDataStream，用于显示账户数据流订阅是否处于活跃状态。
修复了在 session.logon 之后使用 userDataStream.start 不会收到新 listenKey 的错误。

User Data Stream

仅限于 WebSocket API：当您从 websocket 会话注销或取消订阅账户数据流时，新事件 eventStreamTerminated 将会被发出。
当您的现货钱包余额被外部系统锁定/解锁时，新事件 externalLockUpdate 将会被发送。

FIX API

模式中已添加了新的管理消息 News <B>，该消息可用于所有 FIX 服务。收到此消息意味着您的连接即将关闭。

以下更改将在2024 年 12 月 16 日到 2024 年 12 月 20日之间发生：

修复一个错误： BUY 方 OCO 单如果不提供 stopPrice 就会被阻止下单。
在 OCO 中添加了对 TAKE_PROFIT 和 TAKE_PROFIT_LIMIT 的支持。
- 以前，OCO 只能由以下订单类型组成：
  - LIMIT_MAKER + 'STOP_LOSS
  - LIMIT_MAKER + STOP_LOSS_LIMIT
- 现在，OCO 可以由以下订单类型组成：
  - LIMIT_MAKER + STOP_LOSS
  - LIMIT_MAKER + STOP_LOSS_LIMIT
  - TAKE_PROFIT + STOP_LOSS
  - TAKE_PROFIT + STOP_LOSS_LIMIT
  - TAKE_PROFIT_LIMIT + STOP_LOSS
  - TAKE_PROFIT_LIMIT + STOP_LOSS_LIMIT
- 以下请求支持此功能：
  - POST /api/v3/orderList/oco
  - POST /api/v3/orderList/otoco
  - orderList.place.oco
  - orderList.place.otoco
  - NewOrderList<E>
- 错误代码 -1167 将在此次更新后过时，并将在以后的更新中从文档中删除。

2024-10-18

Rest 和 WebSocket API:

注意：根据我们的 SBE 政策，SBE 1：0 模式将于 2024 年 10 月 25 日被禁用废止后 6 个月。
面向生产的 SBE 生命周期已基于本次更改进行了更新。

2024-10-17

Exchange Information 的更改（即 REST API 的 GET /api/v3/exchangeInfo 和 WebSocket API 的 exchangeInfo）。

新的可选参数 showPermissionSets 可用于隐藏 permissionsSets 的权限信息;这可用于减小消息大小。
新的可选参数 symbolStatus 用于仅显示具有指定状态的交易对。（例如：TRADING， HALT， BREAK）

2024-08-26

现货未成交订单计数规则已更新，解释了如何在下订单时减少未成交的订单数量。

2024-08-16

注意： 以下的变更正在逐步推出，可能需要大约一周的时间才能完成。

常规更改：

在市场流动性低的情况下，当提交包含 quoteOrderQty 的市价单（又名反向市价单）被拒绝时，添加了新的错误消息。

2024-08-01

FIX API 和 Drop Copy 会话将于 8 月 8 日 05:00 UTC 上线。

2024-07-26

FIX API 和 Drop Copy 会话已添加到文档中。
实时交换的发布日期尚未确定。

2024-07-22

常规更改：

修复了 klines 的时间戳不正确的 bug。
- REST API：带有 timeZone 参数的 GET /api/v3/klines 和 GET /api/v3/uiKlines
- WebSocket API：带有 timeZone 参数的 klines 和 uiKlines
- WebSocket Streams: <symbol>@kline_<interval>@+08：00

2024-06-11

在 6月11日 UTC 时间 05:00，我们将开始推出新功能 One-Triggers-the-Other (OTO) 订单和 One-Triggers-a-One-Cancels-The-Other (OTOCO) 订单。（请注意，我们可能需要花几个小时来部署到所有服务器。）
- 有关详细信息，请参阅以下页面：
  - REST API：
    - POST /api/v3/orderList/oto
    - POST /api/v3/orderList/otoco
  - WebSocket API：
    - orderList.place.oto
    - orderList.place.otoco
在 6月18日 UTC 时间 05:00，我们将会把买方的订单 ID（b）和卖方的订单 ID（a）从交易流中删除（i.e. <symbol>@trade）。（请注意，我们可能需要花几个小时来部署到所有服务器。）
- WebSocket 账户接口与其相关的文档已经被更改了。
- 要监控您的订单是否是交易的一部分，请订阅 WebSocket 账户接口。

2024-06-06

此功能将在6月6日 UTC时间11:59前上线。

REST API

POST /api/v3/order/cancelReplace 新加可选参数 orderRateLimitExceededMode。

WebSocket API

order.cancelReplace 新加可选参数 orderRateLimitExceededMode。

2024-05-30

WebSocket Streams

Kline 新增加了对 UTC+8 时区的支持。（例如，btcusdt@kline_1d@+08:00）

2024-04-10

以下更新的生效时间已被推迟到 4月25日 05：00 UTC

"交易规范信息"响应中的交易对权限信息已从字段 permissions 移至字段 permissionSets。
字段 permissions 将为空，并将在未来版本中删除。
以前，"permissions":["SPOT","MARGIN"] 代表如果您的账户具有 SPOT 或 MARGIN 权限，您就可以在该交易对上下订单。现在，等效项是 "permissionSets":[["SPOT","MARGIN"]]（请注意额外的方括号）。permissionSets数组中的每个权限数组称为 "permission set"。
交易对的权限现在可以有更多权限类型。例如，"permissionSets":[["SPOT","MARGIN"],["TRD_GRP_004","TRD_GRP_005"]] 指示除了支持以上提过的权限集，也接受 TRD_GRP_004 或 TRD_GRP_005。交易对的 permissionSets 中可以有任意排列组合的权限集。

REST API

otoAllowed 现在将出现在 GET /api/v3/exchangeInfo 上，指示该交易品种是否支持 One-Triggers-the-Other (OTO) 订单。

WebSocket API

otoAllowed 现在将出现在 exchangeInfo 上，指示该交易品种是否支持 One-Triggers-the-Other (OTO) 订单。

SBE

已发布新模式 2:0 Spot_2_0.xml。当前模式 1:0 spot_1_0.xml 将被弃用，并从根据我们模式弃用政策，会将在 6 个月内下线。
在 REST API 或 WebSocket API 上使用模式 1:0 时，消息 ExchangeInfoResponse 中的组"权限"将始终为空。在升级到模式 2:0后，您才可以在 permissionSets 组中查找权限信息。
最新模式仍将支持已弃用的 OCO 请求。
请注意，在模式 2:0 实际发布之前尝试使用它会导致错误。

2024-04-02

注意： 以下的变更将逐步推出，并预计需要大约一周的时间完成。

GET /api/v3/account 新加可选参数 omitZeroBalances，如果启用，则会隐藏所有零余额。
account.status 新加可选参数 omitZeroBalances，如果启用，则会隐藏所有零余额。
以下请求的权重已从 10 增加到 25 （该规定将于2024年4月4日生效）：
- GET /api/v3/trades
- GET /api/v3/historicalTrades
- trades.recent
- trades.historical

User Data Stream

如果 listenKey 过期，将在流中发出新事件 listenKeyExpired。

REST API

REST API 上现已弃用 POST /api/v3/order/oco 接口。从今开始，请使用新的 POST /api/v3/orderList/oco 接口（请注意，新接口使用不同的参数）。

WebSocket API

WebSocket API 上现已弃用 orderList.place 请求。从今开始，请使用新的 orderList.place.oco 请求（请注意，新接口使用不同的参数）。

以下内容将于发布日期大约一周后生效：

"交易规范信息"响应中的交易对权限信息已从字段 permissions 移至字段 permissionSets。
字段 permissions 将为空，并将在未来版本中删除。
以前，"permissions":["SPOT","MARGIN"] 代表如果您的账户具有 SPOT 或 MARGIN 权限，您就可以在该交易对上下订单。现在，等效项是 "permissionSets":[["SPOT","MARGIN"]]（请注意额外的方括号）。permissionSets数组中的每个权限数组称为 "permission set"。
交易对的权限现在可以有更多权限类型。例如，"permissionSets":[["SPOT","MARGIN"],["TRD_GRP_004","TRD_GRP_005"]] 指示除了支持以上提过的权限集，也接受 TRD_GRP_004 或 TRD_GRP_005。交易对的 permissionSets 中可以有任意排列组合的权限集。

REST API

otoAllowed 现在将出现在 GET /api/v3/exchangeInfo 上，指示该交易品种是否支持 One-Triggers-the-Other (OTO) 订单。

WebSocket API

otoAllowed 现在将出现在 exchangeInfo 上，指示该交易品种是否支持 One-Triggers-the-Other (OTO) 订单。

SBE

已发布新模式 2:0 Spot_2_0.xml。当前模式 1:0 spot_1_0.xml 将被弃用，并从根据我们模式弃用政策，会将在 6 个月内下线。
在 REST API 或 WebSocket API 上使用模式 1:0 时，消息 ExchangeInfoResponse 中的组"权限"将始终为空。在升级到模式 2:0后，您才可以在 permissionSets 组中查找权限信息。
最新模式仍将支持已弃用的 OCO 请求。
请注意，在模式 2:0 实际发布之前尝试使用它会导致错误。

2024-02-28

将于 2024 年 3 月 5 日生效。

简单二进制编码 (SBE) 将部署到现货的 Rest API 和 WebSocket API 生产系统上。

更多关于SBE的信息, 请参考常见问题解答 (FAQ)

2024-02-08

现货的 WebSocket API 现在在测试网上支持简单二进制编码(SBE)。

SBE 模式已经更新了 WebSocket API 元数据，但并没有增加 schemaId 或者 version。

仅在 REST API 上使用 SBE 的用户可以继续使用 SBE 模式 128b94b2591944a536ae427626b795000100cf1d，或者更新到新提交的 SBE 模式。
希望在 WebSocket API 上使用 SBE 的用户，需要更新到最新的 SBE 模式。

SBE 的 FAQ 已经更新。

2023-12-08

简单二进制编码 (SBE) 已经在现货测试网上线。生产系统会在随后支持。更多关于SBE的信息, 请参考常见问题解答 (FAQ)

2023-12-04

注意：以下的变更将逐步推出，并预计需要大约一周的时间完成。

错误消息 Precision is over the maximum defined for this asset. 被改为 Parameter '%s' has too much precision.
- 当参数的精度超出允许范围时，将返回此错误消息。例如，如果基础资产（base asset）精度为6，但是设置quantity=0.1234567，则会出现此错误消息。
- 这会影响所有具有以下参数的请求:
  - quantity
  - quoteOrderQty
  - icebergQty
  - limitIcebergQty
  - stopIcebergQty
  - price
  - stopPrice
  - stopLimitPrice
现在，请求查询OCO开单时会正确返回升序的结果。这会影响以下请求：
- REST API: GET /api/v3/openOrderList
- WebSocket API: openOrderList.status
现在，当指定startTime或fromId时，请求查询所有 OCO 订单会正确返回升序的结果。这会影响以下请求：
- REST API: GET /api/v3/allOrderList
- WebSocket API: allOrderLists
修复了一个错误。订单查询请求不再会对新下的订单错误返回-2026 ORDER_ARCHIVED错误。
- REST API: GET /api/v3/order
- WebSocket API: order.status

REST API

新接口 GET /api/v3/account/commission
新接口 GET /api/v3/ticker/tradingDay
GET /api/v3/avgPrice 新加字段 closeTime, 用于显示最后交易时间。
GET /api/v3/klines 和 /api/v3/uiKlines 新加可选参数 timeZone。
POST /api/v3/order/test 和 POST /api/v3/sor/order/test 新加可选参数 computeCommissionRates。
关于发送无效接口的变动：
- 以前，如果查询一个不存在的端点（例如 curl -X GET "https://api.binance.com/api/v3/exchangie"），你会收到 HTTP 404 状态码，以及响应 "<html><body><h2>404 Not found</h2></body></html>"。
- 从现在开始，只有当接受请求头中包含text/html时，HTML响应才会出现在这种情况下。HTTP状态码将保持不变。

WebSocket API

新请求 account.commission
新增请求以允许会话身份验证: (请注意，这些请求只能使用Ed25519密钥。)
- session.logon
- session.logout
- session.status
新请求 ticker.tradingDay
方法 avgPrice 新加字段 closeTime, 用于显示最后交易时间。
方法 klines 和 uiKlines 新加可选参数 timeZone。
方法 order.test 和 sor.order.test 新加可选参数 computeCommissionRates.
修复了一个错误。之前在发送 ping 之前未经请求发送的 pongs 会导致断开连接。

WebSocket Streams

新数据流 <symbol>@avgPrice
请求中的id现在支持和 WebSocket API 里id一样的值:
- 64位有符号整数 (之前是无符号整数)
- 字母数字字符串；最大长度36
- null
修复了一个错误，之前在发送 ping 之前未经请求发送的 pongs 会导致断开连接。

User Data Streams

当事件类型为 executionReport，而执行类型（x）为TRADE_PREVENTION时，字段l、L和Y现在将始终为0。新增字段pl、pL和pY将描述被阻止执行的数量、被阻止执行的价格和被阻止执行的名义金额。这些新字段显示了如果接收方订单没有启用自成交防止功能时，l、L和Y会是什么值。

以下将在发布日期后_大约_一周后生效:

交易对权限将仅影响下单，而不影响取消订单。
- permissions仍然适用于撤消挂单再下单（Cancel-Replace orders）（比如，如果您的账户有使用此请求下单的权限，则将不允许取消操作）。

2023-10-19

从 2023-10-19 00:00 UTC 开始生效

调高如下接口的请求权重:

REST API	WebSocket API	条件	之前的权重	调整后权重
`GET /api/v3/trades`	`trades.recent`	N/A	2	10
`GET /api/v3/depth`	`depth`	Limit 1-100	2	5
		Limit 101-500	10	25
		Limit 501-1000	20	50
		Limit 1001-5000	100	250

2023-10-03

下单量的退回(Order decrement)功能在 06:15 UTC上线.
此功能的更详细信息, 请参考 FAQ

2023-08-25

Websocket API 的 exchangeInfo 中的 RAW REQUESTS 被移除，新增了用于表示WebSocket连接数限制的 CONNECTIONS。

下面的变更会在UTC时间 2023-08-25 00:00 上线

WebSocket API 的 CONNECTIONS 被调整为每5分钟300。
REST API 和 WebSocket API 的 REQUEST_WEIGHT 调整为每分钟6,000。
REST API 中的 RAW_REQUESTS 调整为每5分钟61,000。
之前连接到 WebSocket API 的权重为1。现权重调整到 2。
下表的 REST API 和 WebSocket API 请求的权重被调整:

请求接口	之前请求权重	新请求权重
`GET /api/v3/order` `order.status`	2	4
`GET /api/v3/orderList` orderList.status	2	4
`GET /api/v3/openOrders` `openOrders.status` - 带 `symbol`	3	6
`GET /api/v3/openOrders` `openOrders.status` - 不带 `symbol`	40	80
`GET /api/v3/openOrderList` `openOrderLists.status`	3	6
`GET /api/v3/allOrders` `allOrders`	10	20
`GET /api/v3/allOrderList` `allOrderLists`	10	20
`GET /api/v3/myTrades` `myTrades`	10	20
`GET /api/v3/myAllocations` `myAllocations`	10	20
`GET /api/v3/myPreventedMatches` `myPreventedMatches` - 使用 `preventedMatchId`	1	2
`GET /api/v3/myPreventedMatches` `myPreventedMatches` - 使用 `orderId`	10	20
`GET /api/v3/account` `account.status`	10	20
`GET /api/v3/rateLimit/order` `account.rateLimits.orders`	20	40
`GET /api/v3/exchangeInfo` `exchangeInfo`	10	20
`GET /api/v3/depth` `depth` - Limit 1-100	1	2
`GET /api/v3/depth` `depth` - Limit 101-500	5	10
`GET /api/v3/depth` `depth` - Limit 501-1000	10	20
`GET /api/v3/depth` `depth` - Limit 1001-5000	50	100
`GET /api/v3/aggTrades` `trades.aggregate`	1	2
`GET /api/v3/trades` `trades.recent`	1	2
`GET /api/v3/historicalTrades` `trades.historical`	5	10
`GET /api/v3/klines` `klines`	1	2
`GET /api/v3/uiKlines` `uiKlines`	1	2
`GET /api/v3/ticker/bookTicker` `ticker.book` - 带 `symbol`	1	2
`GET /api/v3/ticker/bookTicker` `ticker.book` - 不带 `symbol` 或者带 `symbols`	2	4
`GET /api/v3/ticker/price` `ticker.price` - 带 `symbol`	1	2
`GET /api/v3/ticker/price` `ticker.price` - 不带 `symbol` 或者带 `symbols`	2	4
`GET /api/v3/ticker/24hr` `ticker.24hr` - 带 `symbol` 或者 `symbols` 带 1-20 交易对	1	2
`GET /api/v3/ticker/24hr` `ticker.24hr` - 带 `symbols` 21-100 交易对	20	40
`GET /api/v3/ticker/24hr` `ticker.24hr` - 不带 `symbol` 或者 `symbols` 带 101 个或者更多交易对	40	80
`GET /api/v3/avgPrice` `avgPrice`	1	2
`GET /api/v3/ticker` `ticker`	2	4
`GET /api/v3/ticker` `ticker` - 请求的最大权重	100	200
`POST /api/v3/userDataStream` `userDataStream.start`	1	2
`PUT /api/v3/userDataStream` `userDataStream.ping`	1	2
`DELETE /api/v3/userDataStream` `userDataStream.stop`	1	2

2023-08-08

智能订单路由(Smart Order Routing：SOR）添加到 API 中。您可以在SOR 常见问题文档中找到更多详细信息。具体上线时间请关注相关公告。

REST API

GET /api/v3/exchangeInfo 变动：
- 返回数据中添加新字段: sors, 用于描述交易中是否使用了 SOR。
GET /api/v3/myPreventedMatches 变动：
- 对于所有的 Prevented Matches，返回数据中添加新字段 makerSymbol 。
为了在下单时使用 SOR 而添加的新接口：
- POST /api/v3/sor/order
- POST /api/v3/sor/order/test
添加新接口: GET /api/v3/myAllocations

WEBSOCKET API

exchangeInfo 变动：
- 返回数据中添加新字段: sors , 用于描述交易中是否使用了 SOR。
myPreventedMatches 变动：
- 对于所有的 Prevented Matches，返回数据中添加新字段 makerSymbol。
为了在下单时使用 SOR 而添加的新请求：
- sor.order.place
- sor.order.test
添加新请求 myAllocations

USER DATA STREAM

executionReport 变动：
- 以下这些字段只适用于下单时使用 SOR 的情况：
  - 新字段 b 代表 matchType
  - 新字段 a 代表 allocId
  - 新字段 k 代表 workingFloor
- 这个字段只适用于订单因为触发 STP 而将过期的情况：
  - 新字段 Cs 代表 counterSymbol

2023-07-18

现在支持使用 Ed25519 类型的 API key。(UI 会在本周发布更新支持)
- Ed25519 API keys 是 RSA API keys 的替代品，使用非对称加密技术来验证您的 API 请求。
- 我们建议切换到 Ed25519 以提高性能和安全性。
  详情请参考API Key 类型。
文档已更新，包括了有关如何使用 Ed25519 key 对有效载荷进行签名的说明。

2023-07-11

注意: 所有更改都将逐步推出，可能需要一周时间才能完成。

错误消息的变动:
- 之前当发送重复交易对时，会返回错误信息: "Mandatory parameter symbols was not sent, was empty/null, or malformed."
- 现在则返回消息: "Symbol is present multiple times in the list", with a new error code -1151
- 受影响的接口:
  - GET /api/v3/exchangeInfo
  - GET /api/v3/ticker/24hr
  - GET /api/v3/ticker/price
  - GET/api/v3/ticker/bookTicker
  - exchangeInfo
  - ticker.24hr
  - ticker.price
  - ticker.book
修复一个bug，当查询没有被存档的订单时候，可能返回错误消息称已经被存档。

Rest API

GET /api/v3/account 变动：
- 返回数据中添加新字段 preventSor。
- 返回数据中添加用户ID的新字段 uid。
GET /api/v3/historicalTrades 变动：
- 鉴权类型从 MARKET_DATA 变更为 NONE。
- 不需要设置 X-MBX-APIKEY 到请求的header中。

Websocket API

account.status 变动：
- 返回数据中添加新字段 preventSor。
- 返回数据中添加用户ID的新字段 uid。
trades.historical 变动：
- 鉴权类型从 MARKET_DATA 变更为 NONE。
- 请求中不需要设置 apiKey。
修改了几个bugs: 当下单时设置 type=MARKET 和 quoteOrderQty, 也被称为"反向市价单":
- 当处于极端市场情况下, 订单不会返回部分成交，或者成交的数量为0甚至是负数。
- 当这种反向市价单的成交数量超过交易对的 maxQty, 订单会因为违反MARKET_LOT_SIZE 过滤器而被拒绝。
修复一个OCO订单的bug: 当使用 trailingDelta 时候, 当任何leg被触发时, trailingTime 值可能不正确。
这些接口的返回数据中添加新字段 transactTime :
- DELETE /api/v3/order
- POST /api/v3/order/cancelReplace
- DELETE /api/v3/openOrders
- DELETE /api/v3/orderList
- order.cancel
- order.cancelReplace
- openOrders.cancelAll
- orderList.cancel

2023-06-06

为了提供系统的冗余能力，新加一个API接入网址: https://api-gcp.binance.com/
- 此网址利用了 GCP (Google Cloud Platform) 的CDN，可能在性能上比api1-api4要慢。

2023-05-26

注意: 所有更改都将逐步推出到我们的所有服务器，并可能需要一周时间才能完成。

以下基本接口可能会提供比 https://api.binance.com 更好的性能但其稳定性略为逊色:
- https://api1.binance.com
- https://api2.binance.com
- https://api3.binance.com
- https://api4.binance.com

2023-05-24

以前的市场数据 URL 已不建议使用。请立即更新您的代码，以防止来自我们的服务被中断
- 来自 data.binance.com 的 API 市场数据现在可以从 data-api.binance.vision 访问。
- 来自 data-stream.binance.com 的 Websocket 市场数据现在可以从 data-stream.binance.vision 访问。

2023-03-13

注意: 所有更改都将逐步推出到我们的所有服务器，并可能需要一周时间才能完成。

某些问题的错误消息已经改进，以便更轻松地进行解决。

情况	之前的错误消息	新错误消息
由于交易权限被禁用，账户无法下订单或取消订单。	This action is disabled on this account.	This account may not place or cancel orders.
当配置在交易对上的权限与账户上的权限不匹配时。		This symbol is not permitted for this account.
当账户在其没有权限的交易对上下订单时。		This symbol is restricted for this account.
当 `symbol` 不在 `TRADING` 时下订单。	Unsupported order combination.	This order type is not possible in this trading phase.
在不支持 `IOC` 或 `FOK` 的交易阶段上使用 `timeinForce` = `IOC` 或 `FOK` 下订单时。	Unsupported order combination.	Limit orders require GTC for this phase.

更正了查询归档订单的错误消息：
- 之前，如果查询了一个归档订单（即状态为 CANCELED 或 EXPIRED，executedQty == 0 而且最后的更新在 90 天以前），错误消息将是：
```
{
    "code": -2013,
    "msg": "Order does not exist."
}
```
- 现在，错误消息为：
```
{
    "code": -2026,
    "msg": "Order was canceled or expired with no executed qty over 90 days ago and has been archived."
}
```
API 请求使用 startTime 和 endTime 的行为：
- 之前，如果 startTime == endTime，一些请求会失败。
- 现在，所有接受 startTime 和 endTime 的 API 请求会允许这些参数相等。这适用于以下接口：
  - Rest API
    - GET /api/v3/aggTrades
    - GET /api/v3/klines
    - GET /api/v3/allOrderList
    - GET /api/v3/allOrders
    - GET /api/v3/myTrades
  - Websocket API
    - trades.aggregate
    - klines
    - allOrderList
    - allOrders
    - myTrades
如果用户的IP地址因违反 IP 速率限制（状态码为 418）而被禁止，那么连接到 WebSocket API 的用户将被断开连接。

虽然以下更改将在发布日期后 大约一周内生效，但是与其相关的文档已经被更改了：

过滤器评估的更改：
- 之前的行为: LOT_SIZE 和 MARKET_LOT_SIZE 要求 (quantity - minQty) % stepSize == 0。
- 新行为: 现在已更改为 (quantity % stepSize) == 0。
使用 quoteOrderQty 的 MARKET订单的错误修复：
- 之前的行为: 订单的状态将始终为 FILLED，即使订单没有完全成交。
- 新行为: 如果订单由于流动性不足而没有完全成交，则订单状态将为 EXPIRED，仅当订单完全成交时状态为 FILLED。

REST API

DELETE /api/v3/order 和 POST /api/v3/order/cancelReplace 的更改:
- 新的可选参数 cancelRestrictions，该参数用于决定是否能成功取消状态为 NEW 或 PARTIALLY_FILLED 的订单。
- 如果由于 cancelRestrictions 而取消订单失败，错误将是：
```
{
    "code": -2011,
    "msg": "Order was not canceled due to cancel restrictions."
}
```

WEBSOCKET API

order.cancel 和 order.cancelReplace 的更改:
- 新的可选参数 cancelRestrictions，该参数用于决定是否能成功取消状态为 NEW 或 PARTIALLY_FILLED 的订单。
- 如果由于 cancelRestrictions 而取消订单失败，错误将是：
```
{
    "code": -2011,
    "msg": "Order was not canceled due to cancel restrictions."
}
```

2023-02-17

WebSocket频率限制变动

WS-API 和 Websocket Stream 现在限制每个IP地址、每5分钟可以发送连接请求的上限是300次。

2023-01-26

根据此公告，Self-Trade Prevention 将在 2023-01-26 08:00 UTC 发布。

2023-01-23

添加了新的 API 集群 https://api4.binance.com

2023-01-19

实际发布日期待定

新功能：Self-Trade Prevention（STP）会添加到系统中。此功能将阻止订单与来自同一账户或者同一 tradeGroupId 账户的订单交易。

请使用现货 REST API 的 GET /api/v3/exchangeInfo 或 Websocket API 的 exchangeInfo 看 STP 的状态。

"defaultSelfTradePreventionMode": "NONE",   // selfTradePreventionMode 的默认值
"allowedSelfTradePreventionModes": [        // selfTradePrevention 的可用模式
    "NONE",
    "EXPIRE_TAKER",
    "EXPIRE_BOTH",
    "EXPIRE_MAKER"
]

在STP 常见问题文档中可以找到更多其它关于 STP 功能的详细信息。

REST API

新的订单状态：EXPIRED_IN_MATCH - 订单由于 STP 触发而过期。
新的接口：
- GET /api/v3/myPreventedMatches - 获取由于 STP 触发而过期的订单。
新的可选参数 selfTradePreventionMode 已添加到以下的接口：
- POST /api/v3/order
- POST /api/v3/order/oco
- POST /api/v3/cancelReplace
如果有预防自我交易(Prevented Match)，所有下单相关的接口会出现新字段：
- tradeGroupId - 仅当账户配置为 tradeGroupId 时才会出现。
- preventedQuantity - 被防止交易的订单数量。
- preventedMatches 数组会有以下的字段：
  - preventedMatchId
  - makerOrderId
  - price
  - takerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_TAKER 或 EXPIRE_BOTH 时才会出现。
  - makerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_MAKER 或 EXPIRE_BOTH 时才会出现。
如果订单因 STP 触发而过期，以下查询订单接口的响应中可以出现新的字段 preventedMatchId 和 preventedQuantity：
- GET /api/v3/order
- GET /api/v3/openOrders
- GET /api/v3/allOrders

WEBSOCKET API

新的订单状态：EXPIRED_IN_MATCH - 订单由于 STP 触发而过期。
新的请求：myPreventedMatches - 获取由于 STP 触发而过期的订单。
新的可选参数 selfTradePreventionMode 已添加到以下的请求：
- order.place
- orderList.place
- order.cancelReplace
如果有防止自我交易，将为所有下订单的请求会出现的新响应：
- tradeGroupId - 仅当账户配置为 tradeGroupId 时才会出现。
- preventedQuantity - 被防止交易的订单数量。
- preventedMatches 数组会有以下的字段：
  - preventedMatchId
  - makerOrderId
  - price
  - takerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_TAKER 或 EXPIRE_BOTH 时才会出现。
  - makerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_MAKER 或 EXPIRE_BOTH 时才会出现。
如果订单因 STP 触发而过期，以下查询订单接口的响应中可以出现新的字段 preventedMatchId 和 preventedQuantity：
- order.status
- openOrders.status
- allOrders

USER DATA STREAM

新的执行类型：TRADE_PREVENTION。
executionReport 的新字段（这些字段只会在订单因 STP 触发而过期时出现）：
- u - tradeGroupId
- v - preventedMatchId
- U - counterOrderId
- A - preventedQuantity
- B - lastPreventedQuantity

2022-12-28

现货 WebSocket API 文档已更新，添加了如何使用 RSA key 签署请求。

2022-12-26

现货的 Websocket API 发布到生产系统中。
现货的 Websocket API 可以通过URL: wss://ws-api.binance.com/ws-api/v3 来访问。

2022-12-15

添加新的RSA签名验证方式
- 文档已更新以显示如何创建 RSA keys。
- 建议在生成 API key 时使用 RSA keys。
- 我们接受PKCS#8（BEGIN PUBLIC KEY）。
- 稍后将添加有关如何上传 RSA public key 的更多详细信息。
现货 WebSocket API 现在可以在 SPOT 测试网上使用。
- WebSocket API 允许通过 WebSocket 连接下订单、取消订单等。
- WebSocket API 是一个独立于 WebSocket 市场数据流的服务。即，下订单和收听市场数据需要两个独立的 WebSocket 连接。
- WebSocket API 与 REST API 相同过滤器和速率限制规则。
- WebSocket API 与 REST API 提供相同的功能，接受相同的参数，返回相同的状态和错误代码。

WEBSOCKET API 会晚些时候在生产系统中可用。

2022-12-13

REST API

错误代码 -1003 的一些错误消息已更改

之前的错误消息: Too much request weight used; current limit is %s request weight per %s %s. Please use the websocket for live updates to avoid polling the API. 改成了：

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.

之前的错误消息: Way too much request weight used; IP banned until %s. Please use the websocket for live updates to avoid bans. 改成了：

Way too much request weight used; IP banned until %s Please use WebSocket Streams for live updates to avoid bans.

2022-12-05

备注： 这些更新正在逐步部署到我们所有的服务器，大约需要一周时间才能完成。

WEBSOCKET

!bookTicker 在 2022-12-07 下线。请改用按 symbol 的最优挂单信息的数据流（<symbol>@bookTicker）。
- 可以通过一个连接订阅多个 <symbol>@bookTicker 数据流。（例如wss://stream.binance.com:9443/stream?streams=btcusdt@bookTicker/bnbbtc@bookTicker）

REST API

新的错误代码 -1135
- 如果参数是无效的 JSON 格式，则会出现此错误代码。
新的错误代码 -1108
- 如果发送的参数的值太长，可能会导致溢出，则会发生此错误。
- 此错误代码可能出现在以下接口：
  - POST /api/v3/order
  - POST /api/v3/order/cancelReplace
  - POST /api/v3/order/oco
GET /api/v3/aggTrades 更新
- 之前的规则: startTime 和 endTime 必须结合使用，并且只能相隔一个小时。
- 新的规则: startTime 和 endTime 可以单独使用，一个小时的限制已被取消。
  - 仅使用 startTime 时，如果limit的值为N, 将返回从此时间开始的N条交易。
  - 仅使用 endTime 时，如果limit的值为N, 将返回到此时间的N条交易.
  - 如果不提供 limit，无论是组合使用还是单独发送，服务器端都将使用默认的 limit。
GET /api/v3/myTrades 更新
- 修复了 symbol + orderId 组合会返回所有交易，可能会超过LIMIT的默认值500。
- 之前的行为： API 将根据发送的参数组合发送特定的错误消息。例如：
```
    {
        "code": -1106,
        "msg": "Parameter X was sent when not required."
    }
```
- 新的行为: 如果接口不支持可选参数组合，那么服务器会返回一般性的错误:
```
    {
        "code": -1128,
        "msg": "Combination of optional parameters invalid."
    }
```
- 添加一个新的参数组合: symbol + orderId + fromId.
- 下面的参数组合不再支持:
  - symbol + fromId + startTime
  - symbol + fromId + endTime
  - symbol + fromId + startTime + endTime
- 当前支持的所有参数组合：
  - symbol
  - symbol + orderId
  - symbol + startTime
  - symbol + endTime
  - symbol + fromId
  - symbol + startTime + endTime
  - symbol+ orderId + fromId

备注： 这些新字段将在发布日期后大约一周出现。

GET /api/v3/exchangeInfo 更新
- 新字段 defaultSelfTradePreventionMode 和 allowedSelfTradePreventionModes
下单，查询订单和撤销订单接口的更新:
- 响应中会出现新的字段 selfTradePreventionMode。
- 以下接口会受到影响:
  - POST /api/v3/order
  - POST /api/v3/order/oco
  - POST /api/v3/order/cancelReplace
  - GET /api/v3/order
  - DELETE /api/v3/order
  - DELETE /api/v3/orderList
GET /api/v3/account 更新
- 响应中会出现新的字段 requireSelfTradePrevention.
以下接口的响应中会出现新字段 workingTime（指示订单何时添加到了订单薄）：
- POST /api/v3/order
- GET /api/v3/order
- POST /api/v3/order/cancelReplace
- POST /api/v3/order/oco
- GET /api/v3/order
- GET /api/v3/openOrders
- GET /api/v3/allOrders
如果trailingDelta作为参数提供给了TAKE_PROFIT，TAKE_PROFIT_LIMIT，STOP_LOSS或 STOP_LOSS_LIMIT的订单，那么下面接口中会出现trailingTime, 用来表示追踪单被激活和跟踪价格变化的时间:
- POST /api/v3/order
- GET /api/v3/order
- GET /api/v3/openOrders
- GET /api/v3/allOrders
- POST /api/v3/order/cancelReplace
- DELETE /api/v3/order
字段 commissionRates 会在 GET /api/v3/acccount 的响应中出现。

USER DATA STREAM

eventType executionReport 有新的字段
- V - selfTradePreventionMode
- D - trailing_time (追踪单被激活时会出现)
- W - workingTime (如果 isWorking=true 会出现)

2022-12-02

新增一个用于访问市场信息的RESTful API URL: https://data.binance.com.
新增一个用于访问市场信息的WebSocket URL: wss://data-stream.binance.com.

2022-09-30

!bookTicker的WebSocket推送的变更.

全市场最优挂单信息推送(!bookTicker)计划在2022年11月下线, 具体下线的时间会在后面通告.
请使用按Symbol的最优挂单信息推送(<symbol>@bookTicker).
多个 <symbol>@bookTicker 可以订阅在一个WebSocket连接上.
- 比如 wss://stream.binance.com:9443/stream?streams=btcusdt@bookTicker/bnbbtc@bookTicker

2022-09-15

这些变动会是滚动发布，可能需要几天才会部署到所有服务器.

接口 GET /api/v3/exchangeInfo 的变动
- 添加一个新的参数 permissions , 用于查询适用于相应权限的所有交易对.
- 如果查询时不提供此参数, 则默认值是 ["SPOT","MARGIN","LEVERAGED"].
  - 这表示如果请求 GET /api/v3/exchangeInfo 时候没有任何参数, 则会返回拥有权限是 SPOT, MARGIN , LEVERAGED 的交易对.
  - 如果要查询其他交易权限, 比如TRD_GRP_004等, 需要在查询参数里设置(比如permissions=TRD_GRP_004).
- 此参数不可以同时和 symbol 或者 symbols 使用.

2022-08-23

此变动会滚动发布, 可能需要一段时间更新到所有服务器上。

接口 GET /api/v3/ticker 与 GET /api/v3/ticker/24hr 变动
- 添加新可选参数 type
- type 可接受的参数值有 FULL 与 MINI
  - FULL 是默认值，也是原来接口所返回的响应
  - MINI 省略了以下字段: priceChangePercent, weightedAvgPrice, bidPrice, bidQty, askPrice, askQty 与 lastQty
添加新错误代码 -1008
- 每当服务器的请求超载时都会发送此消息
- 此错误代码只会在 SPOT API 里出现
接口 GET /api/v3/account 添加新参数 brokered
添加新接口: GET /api/v3/uiKlines
添加新k线间隔: 1s

2022-08-08

REST API

接口 POST /api/v3/order 与 POST /api/v3/order/cancelReplace 变动
- 添加新可选参数 strategyId 与 strategyType
  - strategyId 是用于将订单标识为某策略的参数。
  - strategyType 是用于标识在执行的策略。(例如：如果所有订单属于现货网格策略，订单可设置为strategyType=1000000)
接口 POST /api/v3/order/oco 变动
- 添加新可选参数 limitStrategyId, limitStrategyType, stopStrategyId, stopStrategyType
- 这些是OCO订单里两个leg的策略元数据
- limitStrategyType 和 stopStrategyType 都不能低于 1000000
接口 GET /api/v3/order, GET /api/v3/openOrders 与 GET /api/v3/allOrders 变动
- 新增参数 strategyId 与 strategyType 必须在下单时填上字段才会在回应JSON里返回
接口 DELETE /api/v3/order 与 DELETE /api/v3/openOrders 变动
- 新增参数 strategyId 与 strategyType 必须在下单时填上字段才会在回应JSON里返回

USER DATA STREAM

eventType executionReport 新增参数
- j 代表 strategyId
- J 代表 strategyType
- 必须在下单时填上字段才会在回应里返回

2022-06-20

接口 GET /api/v3/ticker 变动

权重从每symbol 5 降低到 2.
每次请求最多可以有100个交易对.
- 如果symbols请求超过100个交易对, 会收到如下错误信息:
```
{
 "code": -1101,
 "msg": "Too many values sent for parameter 'symbols', maximum allowed up to 100."
}
```
单请求的权重上限为100.
- 比如，如果请求的交易对超过50个，请求的权重是100.

2022-06-15

注意: 此变动不会立刻可用, 会在后面几天上线。

SPOT API

添加新接口 GET /api/v3/ticker
- 基于 windowSize 返回最近的价格变动。
- 无需像 GET /api/v3/ticker/24hr 提供symbols参数。
- 如果不提供 windowSize 参数，默认值是1d。
- 响应和 GET /api/v3/ticker/24hr 相似，但不包括以下数据：prevClosePrice, lastQty, bidPrice, bidQty, askPrice, askQty
添加新接口 POST /api/v3/order/cancelReplace
- 撤消当前的挂单并在同样的交易对上下新订单。
- 过滤器会在撤单前做判断。
  - 例如，MAX_NUM_ORDERS 是 10，如果目前挂单也是10，调用 POST /api/v3/order/cancelReplace会失败。撤单与下单的操作都不会被执行。
- 更新将在几天后上线，升级完毕后才会开启此功能。
GET /api/v3/exchangeInfo 在symbols列表里返回新数据cancelReplaceAllowed。
添加新的过滤器 NOTIONAL
- 基于minNotional 与 maxNotional 值来限制名义价值 (price * quantity)
添加新的过滤器 EXCHANGE_MAX_NUM_ICEBERG_ORDERS
- 账号最大冰山挂单数

WEBSOCKETS

新的symbol ticker流, 可以选择 1h 或者 4h时间窗口：
- 单个交易对: <symbol>@ticker_<window-size>
- 市场所有交易对: !ticker_<window-size>@arr

2022-05-23

Order Book 深度的变动
- 之前深度的数量在一些极端情况下会出现负数.
- 之后深度数量不会溢出, 而是限制在64位的最大值, 这表示深度的数量达到，或者超过了最大值. 最大值和交易对的base asset的精度有关. 比如如果精度是8位小数，最大值则为92,233,720,368.54775807.
- 原有的深度价位, 在修复上线后, 需要价位上有变动, 才能体现新的修复.
哪里有影响?
- 现货深度接口
  - GET /api/v3/depth
- Websocket Streams
  - <symbol>@depth
  - <symbol>@depth@100ms
  - <symbol>@depth<levels>
  - <symbol>@depth<levels>@100ms
MAX_POSITION 的更新
- 如果一个订单的数量(quantity) 可能导致持有仓位溢出, 会触发过滤器 MAX_POSITION.
GET api/v3/aggTrades 更新
- 如果同时提供 startTime 和 endTime, 旧的记录会返回.
如果接口 GET /api/v3/myTrades 中没有提供参数 symbol, 错误消息变为:

{
"code": -1102,
"msg": "Mandatory parameter 'symbol' was not sent, was empty/null, or malformed."
}

下面的接口提供参数 symbols 用于查询多个symbol.
- GET /api/v3/ticker/24hr
- GET /api/v3/ticker/price
- GET /api/v3/ticker/bookTicker
上面接口的权重取决于请求 symbols 的数量, 具体请看下面的列表:

接口	Symbols的数量	权重
`GET /api/v3/ticker/price`	Any	2
`GET /api/v3/ticker/bookTicker`	Any	2
`GET /api/v3/ticker/24hr`	1-20	1
`GET /api/v3/ticker/24hr`	21-100	20
`GET /api/v3/ticker/24hr`	>= 101	40

2022-04-13

REST API

现货交易支持追踪止损(Trailing Stop)订单.
- 追踪止损通过一个新的参数trailingDelta来设置基于市场价的一个自动触发价格.
- 只适用于订单类型: STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT.
- 参数trailingDelta的单位为基点(BIPS).
  - 比如一个STOP_LOSS卖单设置trailingDelta为100, 那么订单会在当前市场价格从下单后的最高点下降1%的时候被触发。(100 / 10,000 => 0.01 => 1%)
- 用于OCO订单的时候, 如果市场变动触发了STOP_LOSS订单, 那么此止损订单变成追踪止损订单.
- 当参数trailingDelta和stopPrice一起使用时, 一旦stopPrice条件被触发，系统会开始追踪当前的价格变动. 从stopPrice价格开始，到基于trailingDelta值之间变动.
- 如果没有提供stopPrice, 系统开始追踪价格从最新价到基于trailingDelta值之间变动.
POST /api/v3/order 变动
- 添加新可选参数 trailingDelta
POST /api/v3/order/test 变动
- 添加新可选参数 trailingDelta
POST /api/v3/order/oco 变动
- 添加新可选参数 trailingDelta
添加新的过滤器 TRAILING_DELTA
- 用于限定 trailingDelta 的最大和最小值.

USER DATA STREAM

User Data Stream 的executionReport添加新参数
- "d" 代表trailingDelta

2022-04-12

Note: 下面的变更会在后面几天上线.

GET api/v3/allOrders 如果没有提供 symbol, 则返回错误信息:

{
 "code": -1102,
 "msg": "Mandatory parameter 'symbol' was not sent, was empty/null, or malformed."
}

修复一个错误信息中的拼写错误。如果账号被禁用了相应的权限(比如提款，交易等), 则服务器返回错误:
```
"This action is disabled on this account."
```
在市场数据(market data)审计中，发现了一些现货的聚合交易数据(aggTrades)中的问题.
- 丢失的记录已经被补回.
- 重复的记录被标记成无效，具体的值设置成如下:
  - p = '0' // price
  - q = '0' // qty
  - f = -1 // ﬁrst_trade_id
  - l = -1 // last_trade_id

2022-02-28

在接口GET /api/v3/exchangeInfo中添加新字段allowTrailingStop.

2022-02-24

现货规则PRICE_FILTER里面的 (price-minPrice) % tickSize == 0 改成 price % tickSize == 0
新添加了一个规则 PERCENT_PRICE_BY_SIDE.
接口 GET api/v3/depth 的变动:
- limit 原先必须是固定值(比如 5, 10, 20, 50, 100, 500, 1000, 5000), 现在可以是在1-5000之间的任意的正整数, 服务器会返回指定的limit数量。(比如如果设置limit=3, 会返回前3个最好的卖价和买价)
- 如果limit超过5000, 服务器也最多返回5000条记录.
- 相应的, 此接口的权重变成:

Limit	Request Weight
1-100	1
101-500	5
501-1000	10
1001-5000	50

GET api/v3/aggTrades 接口的变动:
- 当同时提供参数 startTime 和 endTime, 最旧的订单会优先返回.

2021-12-29

移除交易对类型枚举
新增权限枚举

2021-11-01

新增接口 GET /api/v3/rateLimit/order
- 回传用户在当前时间区间内的下单总数
- 此接口的权重为20

2021-09-14

添加一个基于OpenAPI规范的RESTful API接口定义的YAML文件

2021-08-12

GET api/v3/myTrades 添加新的参数 orderId

2021-05-12

在文档中添加接口的数据来源说明
在每个接口中添加相应的数据源
GET api/v3/exchangeInfo 现在支持单个或者多个交易对查询

2021-04-26

从 April 28, 2021 00:00 UTC 开始,下面接口的权重有如下变动:

GET /api/v3/order 权重改为 2
GET /api/v3/openOrders 权重改为 3
GET /api/v3/allOrders 权重改为 10
GET /api/v3/orderList 权重改为 2
GET /api/v3/openOrderList 权重改为 3
GET /api/v3/account 权重改为 10
GET /api/v3/myTrades 权重改为 10
GET /api/v3/exchangeInfo 权重改为 10

2021-01-01

USER DATA STREAM

移除outboundAccountInfo事件.

2020-11-27

为了优化性能，除了当前的api.binance.com，新加了一些API的集群。如果访问api.binance.com有性能问题，也可以尝试访问:

2020-09-09

用户数据 STREAM

outboundAccountInfo事件不再推荐使用。
outboundAccountInfo事件以后会被删除(具体时间未定) 请使用 outboundAccountPosition 事件.
outboundAccountInfo只推送余额不为0，以及余额刚变成0的资产。

2020-05-01

从2020-05-01 UTC 00:00开始, 所有交易对都会有最多200个挂单的限制, 体现在过滤器MAX_NUM_ORDERS上.
- 已经存在的挂单不会被移除或者撤销。
- 单交易对(symbol)的挂单数量达到或超过200的账号, 无法在此交易对上下新的订单, 除非挂单数量低于200。
- OCO订单在被触发成LIMIT订单, 或者被触发成STOP_LOSS(或者STOP_LOSS_LIMIT)前, 被认为是2个挂单量. 一旦OCO订单被触发, 就只被算作一个挂单。

2020-04-23

WEB SOCKET 连接限制

Websocket服务器每秒最多接受5个消息。消息包括:
- PING帧
- PONG帧
- JSON格式的消息, 比如订阅, 断开订阅.
如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。
单个连接最多可以订阅 1024 个Streams。

2020-03-24

添加过滤器 MAX_POSITION.
- 这个过滤器定义账户允许的基于base asset的最大仓位。一个用户的仓位可以定义为如下资产的总和:
  - base asset的可用余额
  - base asset的锁定余额
  - 所有处于open的买单的数量总和
- 如果用户的仓位大于最大的允许仓位，买单会被拒绝。

2018-11-13

REST API

账户交易权限被禁时允许进行撤单操作。
增加了新的过滤器: PERCENT_PRICE, MARKET_LOT_SIZE, MAX_NUM_ICEBERG_ORDERS。
增加了 RAW_REQUESTS 频率限制. 该限制仅统计请求次数，不统计请求权重。
/api/v3/ticker/price 无symbol参数时，权重增加到2。
/api/v3/ticker/bookTicker 无symbol参数时，权重增加到2。
DELETE /api/v3/order 现在会返回订单撤销前所处的末次状态。
MIN_NOTIONAL 新增两个参数: applyToMarket (是否对市价单生效) and avgPriceMins (对市价单生效时，估算金额时使用过去几分钟的平均价格?).
/api/v1/exchangeInfo 中的限制增加了intervalNum. intervalNum表示该限制针对多少时间间隔进行统计. 例如: intervalNum= 5, interval = minute, 表示该限制对每5分钟内的行为进行统计。

如何计算过去n分钟平均价格:

[对过去n分钟所有订单的数量*价格求和] / 过去n分钟所有订单的数量
如果过去n分钟没有交易发生，则继续向前追溯，直到找到第一个交易，以此价格作为过去n分钟平均价格。
如果该交易对之前从未发生过交易，则无平均价格，亦即无法在该交易对下市价单，必须至少有一个（双方均未限价单）的交易成交后才可以下市价单。
当前系统使用的平均价格可以通过接口 https://api.binance.com/api/v3/avgPrice?symbol=<symbol>查询例如 https://api.binance.com/api/v3/avgPrice?symbol=BNBUSDT

USER DATA STREAM

成交报告中增加了 末次成交金额 (Y)，等于 末次成交量 * 末次成交价格 (L * l).

2018-07-18

REST API

新过滤器: ICEBERG_PARTS
POST api/v3/order 中 newOrderRespType 参数的缺省值更改; MARKET LIMIT 默认为 FULL, 其他默认为 ACK.
POST api/v3/order RESULT 与 FULL 响应中增加 cummulativeQuoteQty
GET api/v3/openOrders 无symbol调用权重下降为 40.
GET api/v3/ticker/24hr 无symbol调用权重下降为 40.
GET /api/v1/trades amount最大可取到1000.
GET /api/v1/historicalTrades amount最大可取到1000.
GET /api/v1/aggTrades amount最大可取到1000.
GET /api/v1/klines amount最大可取到1000.
订单查询结果返回中增加 updateTime 字段，代表该订单末次更新(创建、成交、过期、取消、拒绝等等)时间; time 仅表示创建时间.
订单查询结果中增加 cummulativeQuoteQty字段. 负值表示尚无任何成交，该字段不可用.
REQUESTS 限制更名为 REQUEST_WEIGHT. 避免名字造成的误解。

USER DATA STREAM

订单报告与成交报告中增加cummulativeQuoteQty 字段 (Z). 表示已经成交的金额，即已经花费的金额(买入订单)或已经收到的金额(卖出订单)，均未计算手续费. 此功能增加之前成交的订单在历史订单接口中查询到的该字段可能小于零.
cummulativeQuoteQty/cummulativeQty 可以用来计算该订单已经成交部分的平均价格。
成交报告中增加了 O字段 (订单创建时间)

2018-01-23

GET /api/v1/historicalTrades权重降为 5
GET /api/v1/aggTrades 权重降为 1
GET /api/v1/klines 权重降为 1
GET /api/v1/ticker/24hr 不带symbol参数的权重降为 symbols总数 / 2
GET /api/v3/allOrders 权重降为 5
GET /api/v3/myTrades 权重降为 5
GET /api/v3/account 权重降为 5
GET /api/v1/depth limit=500 权重降为 5
GET /api/v1/depth limit=1000 权重降为 10
websocket 用户增加 -1003 error code

2018-01-20

GET /api/v1/ticker/24hr 单symbol参数调用权重降为 1
GET /api/v3/openOrders 不带symbol参数的权重降为 symbols总数 / 2
GET /api/v3/allOrders 权重降为 15
GET /api/v3/myTrades 权重降为 15
GET /api/v3/order 权重降为 1
自成交现在会在myTrades结果中有两条记录。

2018-01-14

GET /api/v1/aggTrades 权重改为 2
GET /api/v1/klines 权重改为 2
GET /api/v3/order 权重改为 2
GET /api/v3/allOrders 权重改为 20
GET /api/v3/account 权重改为 20
GET /api/v3/myTrades 权重改为 20
GET /api/v3/historicalTrades 权重改为 20

更新日志

2025-06-04​

2025-05-28​

2025-05-22​

2025-04-29​

2025-04-25​

2025-04-21​

2025-04-08​

2025-04-07​

常规更改​

FIX API​

User Data Streams​

将会发生的更改​

2025-04-03​

2025-03-31​

2025-03-10​

2025-03-05​

2025-02-12​

2024-01-28​

2025-01-09​

2024-12-17​

2024-12-09​

2024-10-18​

2024-10-17​

2024-08-26​

2024-08-16​

2024-08-01​

2024-07-26​

2024-07-22​

2024-06-11​

2024-06-06​

2024-05-30​

2024-04-10​

2024-04-02​

2024-02-28​

2024-02-08​

2023-12-08​

2023-12-04​

2023-10-19​

2023-10-03​

2023-08-25​

2023-08-08​

2023-07-18​

2023-07-11​

2023-06-06​

2023-05-26​

2023-05-24​

2023-03-13​

2023-02-17​

2023-01-26​

2023-01-23​

2023-01-19​

2022-12-28​

2022-12-26​

2022-12-15​

2022-12-13​

2022-12-05​

2022-12-02​

2022-09-30​

2022-09-15​

2022-08-23​

2022-08-08​

2022-06-20​

2022-06-15​

2022-05-23​

2022-04-13​

2022-04-12​

2022-02-28​

2022-02-24​

2021-12-29​

2021-11-01​

2021-09-14​

2021-08-12​

2021-05-12​

2021-04-26​

2021-01-01​

2020-11-27​

2020-09-09​

2020-05-01​

2020-04-23​

2025-06-04

2025-05-28

2025-05-22

2025-04-29

2025-04-25

2025-04-21

2025-04-08

2025-04-07

常规更改

FIX API

User Data Streams

将会发生的更改

2025-04-03

2025-03-31

2025-03-10

2025-03-05

2025-02-12

2024-01-28

2025-01-09

2024-12-17

2024-12-09

2024-10-18

2024-10-17

2024-08-26

2024-08-16

2024-08-01

2024-07-26

2024-07-22

2024-06-11

2024-06-06

2024-05-30

2024-04-10

2024-04-02

2024-02-28

2024-02-08

2023-12-08

2023-12-04

2023-10-19

2023-10-03

2023-08-25

2023-08-08

2023-07-18

2023-07-11

2023-06-06

2023-05-26

2023-05-24

2023-03-13

2023-02-17

2023-01-26

2023-01-23

2023-01-19

2022-12-28

2022-12-26

2022-12-15

2022-12-13

2022-12-05

2022-12-02

2022-09-30

2022-09-15

2022-08-23

2022-08-08

2022-06-20

2022-06-15

2022-05-23

2022-04-13

2022-04-12

2022-02-28

2022-02-24

2021-12-29

2021-11-01

2021-09-14

2021-08-12

2021-05-12

2021-04-26

2021-01-01

2020-11-27

2020-09-09

2020-05-01

2020-04-23

2020-03-24