Gemini API可提供哪些Websocket？

Gemini的Websocket API通過`wss：// api.gemini.com/v1/MarketData`提供了實時市場數據，例如訂單簿更新，交易和股票，並提供了用於低延期交易應用程序的JSON消息。

2025/08/03 19:43

Gemini Websocket feeds的概述

Gemini API通過其Websocket Feed提供實時市場數據，使開發人員和交易者能夠接收有關訂單簿更改，交易和股票信息的瞬時更新。這些提要對於需要低延遲數據的應用程序至關重要，例如算法交易系統，市場監控工具和價格警報服務。與需要進行輪詢的REST API不同，WebSocket連接保持持久的雙向通信渠道，減少開銷並確保及時提供數據。

Gemini的主要Websocket端點是wss://api.gemini.com/v1/marketdata 。此端點流提供公共市場數據，並且不需要身份驗證以進行基本訪問。所有消息均以JSON格式傳遞，使其易於解析並集成到各種編程環境中。

可用的Websocket頻道

雙子座支持幾個Websocket渠道，每個渠道旨在提供特定類型的市場數據。可用渠道包括：

• 市場數據提要：訂單簿上的實時更新，包括投標，詢問和貿易執行。
• 心跳消息：表明連接處於活動狀態並傳輸數據的周期信號。
• 股票更新：摘要級別的價格信息，包括最後價格，數量和出價/詢問差。
• 貿易執行通知：交易所完成交易的實時報告。

在建立WebSocket連接時，可以通過指定所需的符號來訪問每個通道。例如，連接到BTCUSD或ETHUSD將傳輸特定於該交易對的數據。

連接到雙子座Websocket

要建立與雙子座Websocket Feed的連接，請按照以下步驟：

• 使用受支持的庫（例如Python中的websocket-client或Node.js中的ws打開Websocket客戶端。
• 連接到端點： wss://api.gemini.com/v1/marketdata 。
• 使用查詢字符串中的symbols參數指定交易對。例如： wss://api.gemini.com/v1/marketdata/BTCUSD 。
• 聆聽傳入的消息並相應處理JSON有效載荷。

這是使用Python的示例：

 import websocket
 import json def on_message（WS，消息）：




data = json.loads(message) print(data) DEF ON_ERROR（WS，錯誤）： data = json.loads(message) print(data)
 
def on_close（ws，close_status_code，close_msg）： print(f'Error: {error}')
 
def on_open（WS）： print('Connection closed')
 
建立連接print('Connected to Gemini WebSocket')
 ws = websocket.websocketapp（'wss：//api.gemini.com/v1/marketdata/btcusd'，
 
 on_open=on_open, on_message=on_message, on_error=on_error, on_close=on_close) ws.run_forever（） on_open=on_open, on_message=on_message, on_error=on_error, on_close=on_close)

該腳本連接到BTCUSD市場數據供稿並打印所有傳入消息。收到的數據包括事件類型，符號，投標，詢問和交易。

了解Websocket消息結構

從Gemini Websocket收到的每條消息都包含標準化的JSON結構。關鍵字段包括：

• 類型：指示消息類別，例如update ， heartbeat或initial 。
• EventID ：事件的唯一標識符。
• 時間戳：事件發生時的UNIX時間戳。
• 符號：交易對（例如， BTCUSD ）。
• 出價和詢問：價格水平和相應數量的陣列。
• 更改：訂單簿的更新清單，顯示價格，金額和側面（ buy ） sell

示例更新消息：

 {
 'type': 'update',
 'eventId': 123456789,
 'timestamp': 1717000000000,
 'symbol': 'BTCUSD',
 'changes': [ ['buy', '65000.00', '0.5'], ['sell', '65001.50', '0.3']

這是給出的
}

在此示例中，更改陣列顯示為0.5 BTC的65000.00的新出價，並在65001.50處顯示為0.3 BTC的新競標。客戶必須維護訂單簿的本地副本，並逐步應用這些更改以反映當前的市場狀態。

處理訂單書同步

由於Websocket更新的增量性質，正確初始化訂單簿至關重要。 Gemini在連接時發送了一個初始快照，然後是更新消息。確保准確性：

• 存儲初始出價，並在收到第一條消息後詢問。
• 將每個隨後的changes條目應用於本地訂單書。
• 按降序排序競標，並按價格提高順序。
• 當數量達到零時，請刪除價格水平。

例如，在處理['buy', '65000.00', '0.0']的更改時，應從訂單書中刪除以65000.00的出價。維護此邏輯可確保您的應用程序反映了市場的真實狀態。

費率限制和連接管理

Gemini並未對Websocket連接施加嚴格的速率限制，因為它們是為連續流媒體設計的。但是，由於不活動或消息積壓過多，連接可能會終止。保持可靠性：

• 用指數向後進行重新連接邏輯。
• 監視Connection closed事件並重新啟動會話。
• 使用心跳機制來驗證連接健康。
• 限制並發訂閱的數量，以避免淹沒客戶端。

每個連接只能訂閱一個符號。要監視多對，請為每個對建立單獨的Websocket實例。

常見問題

如何同時訂閱多個交易對？

要接收多個符號的數據，請為每個交易對打開一個單獨的Websocket連接。例如，將一個連接用於BTCUSD ，而將另一個連接用於ETHUSD 。單個插座上沒有多個符號的廣播模式。

更改陣列中的“ 0”數量是多少？

更改字段中的“ 0.0”數量表示相應的價格水平已從訂單簿中刪除。例如， ['sell', '65001.50', '0.0']表示在65001.50處的詢問已完全填充或取消。

訪問Websocket Feed需要身份驗證嗎？

不，公共市場數據Websocket Feed不需要API鍵或身份驗證。所有用戶都可以訪問它。但是，私人提要（例如，用於訂單狀態）需要通過Gemini Exchange API進行身份驗證的Websocket連接。

心跳多久發送一次？

心跳消息大約每5秒發送一次。它們包含一種type: 'heartbeat'字段，可用於確認連接處於活動狀態，並實時傳遞消息。