Spot WebSocket API
string · 必须string · enum · 必须objectstringinteger · int64integer · int64
string · 必须string · enum · 必须objectstringinteger · int64integer · int64
string · 必须string · enum · 必须integer · int64 · 必须number · float · max: 60000stringinteger · int64integer · int64
string · 必须string · enum · 必须integerstringinteger · int64object
显示所有订阅
注意:
- 用户按需要跟踪相关帐户的对应订阅情况。
WSS
session.subscriptions
wss://ws-api.binance.com:443/ws-api/v3
显示所有订阅 › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
session.subscriptions
示例: session.subscriptions
params显示所有订阅 › 响应
Successful Response
显示所有订阅
id示例: d3df5a22-88ea-4fe0-9f4e-0fcea5d418b7
status示例: 200
object[]
示例: [{"subscriptionId":0},{"subscriptionId":1}]
subscriptionId示例: 0
订阅用户数据流 (USER_STREAM)
订阅当前 WebSocket 连接中的用户数据流。
注意:
- 此方法需要使用 Ed25519 密钥并经过鉴权的 WebSocket 连接。请参考
session.logon。 - 如果需要查看订阅状态,可以通过
session.status查询,当userDataStream字段值为true时,表示您有一个有效的订阅。 - 用户数据流在 JSON 和 SBE 会话 中均可用。
- 有关事件格式详情,请参阅 用户数据流。
- 对于 SBE,仅支持 SBE 模式 2:1 或更高版本。
WSS
userDataStream.subscribe
wss://ws-api.binance.com:443/ws-api/v3
订阅用户数据流 (USER_STREAM) › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.subscribe
示例: userDataStream.subscribe
params订阅用户数据流 (USER_STREAM) › 响应
Successful Response
订阅用户数据流
id示例: d3df8a21-98ea-4fe0-8f4e-0fcea5d418b7
status示例: 200
object
subscriptionId示例: 0
通过签名订阅的方式订阅用户数据流 (USER_STREAM)
WSS
userDataStream.subscribe.signature
wss://ws-api.binance.com:443/ws-api/v3
通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 授权
这是一个签名端点,必须在请求参数中包含签名。了解如何生成有效签名,请参考端点安全类型
通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.subscribe.signature
示例: userDataStream.subscribe.signature
object · 必须
timestamp用于请求签名的 Unix 时间戳,单位为毫秒或微秒。该值必须反映客户端当前时间,并会在签名接口中由服务器进行校验。
示例: 1770736694138
recvWindow支持最多三位小数的精度(例如 6000.346),以便可以指定微秒。
示例: 5000
通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 响应
Successful Response
通过签名订阅的方式订阅用户数据流
id示例: d3df8a22-98ea-4fe0-9f4e-0fcea5d418b7
status示例: 200
object
subscriptionId示例: 0
取消订阅用户数据流
取消订阅当前 WebSocket 连接中的用户数据流。
请注意 session.logout 只会关闭由 userDataStream.subscribe 创建的订阅,并不会关闭通过 userDataStream.subscribe.signature 创建的订阅。
WSS
userDataStream.unsubscribe
wss://ws-api.binance.com:443/ws-api/v3
取消订阅用户数据流 › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.unsubscribe
示例: userDataStream.unsubscribe
object
subscriptionId不带参数调用时,将关闭所有订阅。带 subscriptionId 参数调用时,将尝试关闭该订阅ID对应的订阅(如果存在)。
示例: 1
取消订阅用户数据流 › 响应
Successful Response
取消订阅用户数据流
id示例: d3df8a21-98ea-4fe0-8f4e-0fcea5d418b7
status示例: 200
result