Spot WebSocket API
string · 必须string · enum · 必须objectstringinteger · int64integer · int64
string · 必须string · enum · 必须objectstringinteger · int64integer · int64
string · 必须string · enum · 必须integer · int64 · 必须string · 必须number · float · max: 60000stringinteger · int64integer · int64
string · 必须string · enum · 必须integerstringinteger · int64object
WebSocket 显示所有订阅
注意:
- 用户按需要跟踪相关帐户的对应订阅情况。
WSS
session.subscriptions
wss://ws-api.binance.com:443/ws-api/v3
WebSocket 显示所有订阅 › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
session.subscriptions
示例: session.subscriptions
paramsWebSocket 显示所有订阅 › 响应
Successful Response
显示所有订阅
id示例: d3df5a22-88ea-4fe0-9f4e-0fcea5d418b7
status示例: 200
object[]
subscriptionId示例: 0
订阅用户数据流
WSS
userDataStream.subscribe
wss://ws-api.binance.com:443/ws-api/v3
订阅用户数据流 › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.subscribe
示例: userDataStream.subscribe
params订阅用户数据流 › 响应
Successful Response
订阅用户数据流
id示例: d3df8a21-98ea-4fe0-8f4e-0fcea5d418b7
status示例: 200
object
subscriptionId示例: 0
WebSocket 通过签名订阅的方式订阅用户数据流 (USER_STREAM)
WSS
userDataStream.subscribe.signature
wss://ws-api.binance.com:443/ws-api/v3
WebSocket 通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 授权
这是一个签名端点,必须在请求参数中包含签名。了解如何生成有效签名,请参考端点安全类型
WebSocket 通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.subscribe.signature
示例: userDataStream.subscribe.signature
object · 必须
timestamp用于请求签名的 Unix 时间戳,单位为毫秒. 该值必须反映客户端当前时间,并会在签名接口中由服务器进行校验.
示例: 1770736694138
apiKey访问此接口需要 API Key,并且必须在请求头中携带。关于如何创建 API Key,请参考:https://www.binance.com/cn/support/faq/detail/360002502072。
示例: API_KEY
recvWindow支持最多三位小数的精度(例如 6000.346),以便可以指定微秒。
示例: 5000
WebSocket 通过签名订阅的方式订阅用户数据流 (USER_STREAM) › 响应
Successful Response
通过签名订阅的方式订阅用户数据流
id示例: d3df8a22-98ea-4fe0-9f4e-0fcea5d418b7
status示例: 200
object
subscriptionId示例: 0
WebSocket 取消订阅用户数据流
取消订阅当前 WebSocket 连接中的用户数据流。
请注意 session.logout 只会关闭由 userDataStream.subscribe 创建的订阅,并不会关闭通过 userDataStream.subscribe.signature 创建的订阅。
WSS
userDataStream.unsubscribe
wss://ws-api.binance.com:443/ws-api/v3
WebSocket 取消订阅用户数据流 › 请求参数 可选
id客户端生成的请求标识符。
示例: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
userDataStream.unsubscribe
示例: userDataStream.unsubscribe
object
subscriptionId不带参数调用时,将关闭所有订阅。带 subscriptionId 参数调用时,将尝试关闭该订阅ID对应的订阅(如果存在)。
示例: 1
WebSocket 取消订阅用户数据流 › 响应
Successful Response
取消订阅用户数据流
id示例: d3df8a21-98ea-4fe0-8f4e-0fcea5d418b7
status示例: 200
result