跳到主要内容

市场数据连接

  • 本篇所列出的所有wss接口，共有如下两种连接方式：

    • 连接方式一：

    • Base Url：wss://dstream.binance.com

    • 订阅单一stream格式为 /ws/<streamName>

    • 组合streams的URL格式为 /stream?streams=<streamName1>/<streamName2>/<streamName3>

    • 连接样例：

    • wss://dstream.binance.com/ws/bnbusdt@aggTrade

    • wss://dstream.binance.com/stream?streams=bnbusdt@aggTrade/btcusdt@markPrice

    • 连接方式二：

    • Base Url：wss://dstream-auth.binance.com

    • 订阅单一stream格式为 /ws/<streamName>?listenKey=<validateListenKey>

    • 组合streams的URL格式为 /stream?streams=<streamName1>/<streamName2>/<streamName3>&listenKey=<validateListenKey>

    • <validateListenKey>在建立连接时，必须为一个有效的listenKey

    • 连接样例：

    • wss://dstream-auth.binance.com/ws/btcusdt@markPrice?listenKey=XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh

    • wss://dstream-auth.binance.com/stream?streams=btcusdt@markPrice@1s/bnbusdt@markPrice&listenKey=XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh

  • 订阅组合streams时，事件payload会以这样的格式封装 {"stream":"<streamName>","data":<rawPayload>}

  • stream名称中所有交易对均为小写。

  • 每个链接有效期不超过24小时，请妥善处理断线重连。

  • 服务端每3分钟会发送ping帧，客户端应当在10分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于10分钟每次的频率发送pong帧保持链接)。

  • Websocket服务器每秒最多接受10个订阅消息。

  • 如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。

  • 单个连接最多可以订阅 200 个Streams。