跳到主要内容

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 服务器每3分钟发送Ping消息。
    • 如果Websocket服务器在10分钟之内没有收到Pong消息应答,连接会被断开。
    • 当客户收到ping消息,必需尽快回复pong消息,同时payload需要和ping消息一致。
    • 未经请求的pong消息是被允许的,但是不会保证连接不断开。对于这些pong消息,建议payload为空
  • 响应中如有数组,数组元素以时间时间顺序排列,越早的数据越提前。
  • JSON 响应中的所有时间和时间戳相关字段均以UTC 毫秒为默认单位。要以微秒为单位接收信息,请在 URL 中添加参数 timeUnit=MICROSECONDtimeUnit=microsecond
  • 时间戳参数(例如 startTimeendTimetimestamp)可以以毫秒或微秒为单位传递。
  • 除非另有说明,所有字段名称和值都大小写敏感