WebSocket
WebSocket 是基于 TCP 的持久双向连接协议:客户端只需打开一次连接,此后服务器一有新数据就会推送消息。该协议定义在 RFC 6455(2011)中;URL 以 ws:// 或 wss:// 开头,后者使用 TLS 加密。
连接如何工作
连接以带有 Upgrade: websocket 头的普通 HTTP 请求开始。服务器返回 101 Switching Protocols,之后消息在同一条 TCP 连接上双向流动,无需新的请求。Ping 和 pong 控制帧用来确认对方仍然在线。
使用 REST API 时,每次更新都要主动请求,这就是轮询。使用 WebSocket 时,服务器自己发送更新,但你需要保持连接、断线后重连,并且要以数据到达的速度处理数据流。
交易所中的 WebSocket
交易所通过 WebSocket 推送成交和订单簿的变化。在 Binance 上,btcusdt@trade 流推送每一笔 BTC/USDT 成交,btcusdt@depth@100ms 每 100 毫秒推送一次订单簿变化(Binance 文档)。
// 浏览器:来自 Binance 的 BTC/USDT 成交,每笔成交一条消息
const ws = new WebSocket(
'wss://stream.binance.com:9443/ws/btcusdt@trade'
);
ws.onmessage = (event) => {
const trade = JSON.parse(event.data);
console.log(trade.p, trade.q); // 价格和数量
};
深度流只发送变化。完整的订单簿由 REST 快照(/api/v3/depth)加上数据流事件构建,并按更新 ID 对齐;如果漏掉了事件,就要从头重建订单簿。单个 Binance 连接最长维持 24 小时。
WebSocket 与 Genesis API
Genesis API 没有 WebSocket:数据通过 REST 提供,输出的新鲜度由套餐决定,从 Trial 的 60 秒到 Max 的 5 秒。Genesis Arbitrage 自己收集交易所的数据流:在市场订单簿响应中,source 字段表明订单簿来自 WebSocket(ws)还是 REST(rest),age_sec 给出其存在的秒数。
| 任务 | 适合的方式 |
|---|---|
| 下单并在毫秒级做出反应 | 交易所的 WebSocket 和交易 API |
| 在内存中维护单个交易对的完整订单簿 | 交易所的 WebSocket 加 REST 快照 |
| 扫描 20 多家交易所的价差、提醒、看板 | 通过 REST 使用 Genesis API,按套餐的新鲜度轮询 |
无法通过 Genesis API 交易:订单需通过交易所自己的 API 提交,风险自负。
另见:延迟、webhook、订单簿 API、加密货币 API:类型与选择方法。
常见问题
Genesis API 有 WebSocket 吗?
没有。所有请求都是对 REST API 的 HTTP GET 调用,返回 JSON,数据新鲜度取决于套餐:60、30、10 或 5 秒。