跳到主要内容

API 基本信息

  • 本篇所列出的 wss 接口的 base URL:wss://ws-api.binance.com:443/ws-api/v3
    • 如果使用标准443端口时遇到问题,可以使用替代端口9443。
    • 现货测试网的 base URL 是 wss://testnet.binance.vision/ws-api/v3
  • 每个到 base URL 的链接有效期不超过24小时,请妥善处理断线重连。
  • WebSocket 服务器每20秒发送 PING 消息。
    • 如果websocket 服务器没有在一分钟之内收到PONG 消息应答,连接会被断开。
    • 当客户收到PING消息,必须尽快回复PONG消息,同时payload需要和PING消息一致。
    • 服务器允许未经请求的PONG消息,但这不会保证连接不断开。对于这些PONG 消息,建议payload为空。
  • 响应中如有数组,数组元素以时间时间顺序排列,越早的数据越提前。
  • JSON 响应中的所有时间和时间戳相关字段均以UTC 毫秒为默认单位。要以微秒为单位接收信息,请在 URL 中添加参数 timeUnit=MICROSECONDtimeUnit=microsecond
  • 时间戳参数(例如 startTimeendTimetimestamp)可以以毫秒或微秒为单位传递。
  • 除非另有说明,所有字段名称和值都大小写敏感