更新日志
最近更新: 2024-12-17
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-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 将在此次更新后过时,并将在以后的更新中从文档中删除。
- 以前,OCO 只能由以下订单类型组成:
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
- REST API: 带有
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
- REST API:
- 有关详细信息,请参阅以下页面:
- 在 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
- REST API:
- 现在,当指定
startTime
或fromId
时,请求查询所有 OCO 订单会正确返回升序的结果。这会影响以下请求:- REST API:
GET /api/v3/allOrderList
- WebSocket API:
allOrderLists
- REST API:
- 修复了一个错误。订单查询请求不再会对新下的订单错误返回
-2026 ORDER_ARCHIVED
错误。- REST API:
GET /api/v3/order
- WebSocket API:
order.status
- REST API:
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
。
- 对于所有的 Prevented Matches, 返回数据中添加新字段
- 为了在下单时使用 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
。
- 对于所有的 Prevented Matches, 返回数据中添加新字段
- 为了在下单时使用 SOR 而添加的新请求:
sor.order.place
sor.order.test
- 添加新请求
myAllocations
USER DATA STREAM
executionReport
变动:- 以下这些字段只适用于下单时使用 SOR 的情况:
- 新字段
b
代表matchType
- 新字段
a
代表allocId
- 新字段
k
代表workingFloor
- 新字段
- 这个字段只适用于订单因为触发 STP 而将过期的情况:
- 新字段
Cs
代表counterSymbol
- 新字段
- 以下这些字段只适用于下单时使用 SOR 的情况:
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
要慢。
- 此网址利用了 GCP (Google Cloud Platform) 的CDN,可能在性能上比
2023-05-26
注意: 所有更改都将逐步推出到我们的所有服务器,并可能需要一周时间才能完成。
- 以下基本接口可能会提供比 https://api.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 下订单时。 | 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
- Rest API
- 之前,如果
-
如果用户的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)
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
.