Copy page

（已弃用）交易数据流

连接

• 本篇所列出 API 接口的 base URL : https://api.binance.com
• 用于订阅账户数据的 listenKey 从创建时刻起有效期为60分钟。
• 可以通过 PUT 一个 listenKey 延长60分钟有效期。
• 可以通过 DELETE 一个 listenKey 立即关闭当前数据流，并使该 listenKey 无效。
• 在具有有效 listenKey 的帐户上执行POST将返回当前有效的 listenKey 并将其有效期延长60分钟。
• 一个listenKey就是一个数据流。
• 用户可以侦听/订阅数个数据流。
• websocket 接口的 base URL: wss://stream.binance.com:9443
• 订阅账户数据流的 stream 名称为 /ws/<listenKey> 或 /stream?streams=<listenKey>
• 每个链接有效期不超过24小时，请妥善处理断线重连。
• 账户数据流的消息不保证严格时间序; 请使用 E 字段进行排序

---

订单更新

事件描述

订单通过executionReport事件进行更新。

执行类型:

• NEW - 新订单已被引擎接受。
• CANCELED - 订单被用户取消。
• REPLACED - (保留字段，当前未使用)
• REJECTED - 新订单被拒绝 （这信息只会在撤消挂单再下单中发生，下新订单被拒绝但撤消挂单请求成功）。
• TRADE - 订单有新成交。
• EXPIRED - 订单已根据 Time In Force 参数的规则取消（e.g. 没有成交的 LIMIT FOK 订单或部分成交的 LIMIT IOC 订单）或者被交易所取消（e.g. 强平或维护期间取消的订单）。
• TRADE_PREVENTION - 订单因 STP 触发而过期。

事件类型

executionReport

Payload

Schema: executionReport

如果订单是OCO，则除了显示executionReport事件外，还将显示一个名为ListStatus的事件。

Schema: listStatus

---

账户更新

事件描述

每当帐户余额发生更改时，都会发送一个事件outboundAccountPosition，其中包含可能由生成余额变动的事件而变动的资产。

事件类型

outboundAccountPosition

Payload

Schema: outboundAccountPosition

---

余额更新

事件描述

当下列情形发生时更新:

• 账户发生充值或提取
• 交易账户之间发生划转(例如 现货向杠杆账户划转)

事件类型

balanceUpdate

Payload

Schema: balanceUpdate

---

Listen Key已过期

事件描述

当监听 listen key 过期时会发送此事件。此后不会再发送任何事件，直到创建新的 listenKey。正常关闭流时不会推送该事件。

事件类型

listenKeyExpired

Payload

Schema: listenKeyExpired