跳到主要内容

账户信息流连接

  • 本篇所列出REST接口的baseurl https://fapi.binance.com

  • 用于订阅账户数据的 listenKey 从创建时刻起有效期为60分钟

  • 可以通过PUT一个listenKey延长60分钟有效期,如收到-1125报错提示此listenKey不存在,建议重新使用POST /fapi/v1/listenKey生成listenKey

  • 可以通过DELETE一个 listenKey 立即关闭当前数据流,并使该listenKey 无效

  • 在具有有效listenKey的帐户上执行POST将返回当前有效的listenKey并将其有效期延长60分钟

  • 本篇所列出的websocket接口,连接方式如下:

    • Base Url: wss://fstream.binance.com/private
    • 订阅账户数据流的stream名称为 /ws/`<listenKey>`
    • 连接样例:
    • wss://fstream.binance.com/private/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh
  • 每个链接有效期不超过24小时,请妥善处理断线重连。

  • 消息顺序保证:

    • 对于同一用户的单一 Websocket 连接,相同事件类型的消息(例如 ACCOUNT_UPDATEORDER_TRADE_UPDATE)在 T(来自撮合引擎的成交时间)和 E(消息生成时的事件时间)两个字段上都严格有序
    • 建议:使用 E 字段进行更新排序,特别是在以下情况下:
      • 比较不同事件类型的事件时(例如 ORDER_TRADE_UPDATE 与市场数据流如 aggTrade)。
      • 来自不同服务的事件可能具有相同的 T 但由于处理时间的差异而具有不同的 E 值。
      • 对于同一连接上的相同事件类型,TE 都保持严格有序,因此可以可靠地使用任一字段。
  • 考虑到剧烈行情下, RESTful接口可能存在查询延迟,我们强烈建议您优先从Websocket user data stream推送的消息来获取订单,仓位等信息。