WebSocket 账户接口(2024-04-02)
基本信息
- 本篇所列出API接口的base url : https://api.binance.com
- 用于订阅账户数据的
listenKey
从创建时刻起有效期为60分钟 - 可以通过
PUT
一个listenKey
延长60分钟有效期 - 可以通过
DELETE
一个listenKey
立即关闭当前数据流,并使该listenKey
无效 - 在具有有效
listenKey
的帐户上执行POST
将返回当前有效的listenKey
并将其有效期延长60分钟 - websocket接口的baseurl: wss://stream.binance.com:9443
- U订阅账户数据流的stream名称为 /ws/\<listenKey> 或 /stream?streams=\<listenKey>
- 每个链接有效期不超过24小时,请妥善处理断线重连。
- 账户数据流的消息不保证严格时间序; 请使用 E 字段进行排序
与Websocket账户接口相关的REST接口
#
生成 Listen Key (USER_STREAM)开始一个新的数据流。除非发送 keepalive,否则数据流于60分钟后关闭。如果该帐户具有有效的listenKey
,则将返回该listenKey
并将其有效期延长60分钟。
权重: 1
参数: NONE
响应:
#
延长 Listen Key 有效期 (USER_STREAM)有效期延长至本次调用后60分钟, 建议每30分钟发送一个 ping。
权重: 1
参数:
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
listenKey | STRING | YES |
响应:
#
关闭 Listen Key (USER_STREAM)关闭某账户数据流
权重: 1
参数:
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
listenKey | STRING | YES |
响应:
Websocket推送事件
#
账户更新每当帐户余额发生更改时,都会发送一个事件outboundAccountPosition
,其中包含可能由生成余额变动的事件而变动的资产。
Payload
#
余额更新当下列情形发生时更新:
- 账户发生充值或提取
- 交易账户之间发生划转(例如 现货向杠杆账户划转)
Payload
#
订单更新订单通过executionReport
事件进行更新。
Payload:
备注: 通过将Z
除以z
可以找到平均价格。
executionReport
中的特定条件时才会出现的字段#
这些字段仅在满足特定条件时才会出现。有关这些参数的更多信息,请参阅 现货交易API术语表。
字段 | 名称 | 描述 | 示例 |
---|---|---|---|
d | Trailing Delta | 出现在追踪止损订单中。 | "d": 4 |
D | Trailing Time | "D": 1668680518494 | |
j | Strategy Id | 如果在请求中添加了strategyId 参数,则会出现。 | "j": 1 |
J | Strategy Type | 如果在请求中添加了strategyType 参数,则会出现。 | "J": 1000000 |
v | Prevented Match Id | 只有在因为 STP 导致订单失效时可见。 | "v": 3 |
A | Prevented Quantity | "A":"3.000000" | |
B | Last Prevented Quantity | "B":"3.000000" | |
u | Trade Group Id | "u":1 | |
U | Counter Order Id | "U":37 | |
Cs | Counter Symbol | "Cs": "BTCUSDT" | |
pl | Prevented Execution Quantity | "pl":"2.123456" | |
pL | Prevented Execution Price | "pL":"0.10000001" | |
pY | Prevented Execution Quote Qty | "pY":"0.21234562" | |
W | Working Time | 只有在订单在订单簿上时可见 | "W": 1668683798379 |
b | Match Type | 只有在订单有分配时可见 | "b":"ONE_PARTY_TRADE_REPORT" |
a | Allocation ID | "a":1234 | |
k | Working Floor | 只有在订单可能有分配时可见 | "k":"SOR" |
uS | UsedSor | 只有在订单使用 SOR 时可见 | "uS":true |
如果订单是OCO,则除了显示executionReport
事件外,还将显示一个名为ListStatus
的事件。
Payload
可能的执行类型:
- NEW - 新订单已被引擎接受。
- CANCELED - 订单被用户取消。
- REPLACED - (保留字段,当前未使用)
- REJECTED - 新订单被拒绝 (这信息只会在撤消挂单再下单中发生,下新订单被拒绝但撤消挂单请求成功)。
- TRADE - 订单有新成交。
- EXPIRED - 订单已根据 Time In Force 参数的规则取消(e.g. 没有成交的 LIMIT FOK 订单或部分成交的 LIMIT IOC 订单)或者被交易所取消(e.g. 强平或维护期间取消的订单)。
- TRADE_PREVENTION - 订单因 STP 触发而过期。
请查阅公开API参数文档获取更多枚举定义。
#
Listen Key 已过期当监听 listen key 过期时会发送此事件。此后不会再发送任何事件,直到创建新的 listenKey
。
正常关闭流时不会推送该事件。
Payload: