如何使用UPBIT的Websocket接口？

UPBIT的Websocket界面提供實時市場數據，從而實現快速交易；本指南涵蓋了設置，訂閱和數據處理，以進行有效交易。

2025/04/14 22:35

使用UPBIT的Websocket界面可以顯著增強您接收實時市場數據並以最小延遲執行交易的能力。本文將指導您完成設置和使用UPBIT的Websocket接口的過程，從而涵蓋從初始連接到處理實時數據的所有內容。

了解Upbit的Websocket界面

UPBIT的Websocket界面旨在提供實時市場數據，包括訂單簿更新，貿易執行和其他關鍵信息。與需要定期進行輪詢的RESTFUL API不同，WebSocket連接保持持久鏈接，從而在事件發生時立即進行數據傳輸。這對於需要實時更新的應用程序特別有用，例如交易機器人和市場分析工具。

設置Websocket連接

要與UPBIT的WebSocket服務器建立連接，您需要使用WebSocket客戶端庫。許多編程語言都提供此類庫，包括JavaScript，Python和Java。這是使用Python的websocket-client庫設置連接的方法：

• 安裝WebSocket客戶端庫：您可以通過在終端中運行pip install websocket-client來執行此操作。
• 導入必要的模塊：在您的Python腳本中，添加import websocket 。
• 定義Websocket URL ：UPBIT的Websocket URL是wss://api.upbit.com/websocket/v1 。
• 建立連接：使用websocket.create_connection()函數連接到Websocket URL。

這是建立連接的示例代碼片段：

 import websocket ws = websocket.create_connection（'wss：//api.upbit.com/websocket/v1'）

訂閱市場數據

連接後，您需要訂閱您感興趣的特定市場數據。 UPBIT允許您訂閱各種類型的數據，例如訂單簿更新，貿易刻度和股票數據。

• 發送訂閱請求：建立連接後，發送JSON形式的訂閱請求。例如，要訂閱BTC/KRW對的訂單簿，您將發送：

 {
 'type': 'subscribe',
 'channels': [ { 'name': 'orderbook', 'symbols': ['KRW-BTC'] }

這是給出的
}

• 使用Python發送訂閱請求：使用ws.send()方法發送訂閱請求。

 subscription = {
 'type': 'subscribe',
 'channels': [ { 'name': 'orderbook', 'symbols': ['KRW-BTC'] }

這是給出的
}
ws.send（json.dumps（訂閱））

處理實時數據

訂閱後，您將開始從UPBIT接收實時數據。您需要設置一種機制來有效地處理此數據。

• 設置一個循環以接收消息：使用循環從Websocket連接連續接收消息。在Python中，您可以使用ws.recv()方法接收數據。

 import json而真：




result = ws.recv() data = json.loads(result) print(data)
解析和處理接收到的數據：根據收到的數據類型，您需要對其進行解析並相應地處理。例如，如果您收到訂單數據數據，則可能需要更新本地訂單簿表示。
管理連接
維護穩定的Websocket連接對於實時應用程序至關重要。以下是管理連接的一些技巧：
 
實施重新連接邏輯：如果連接丟失，則您的應用程序應嘗試重新連接。您可以使用try-except塊來處理連接錯誤並嘗試重新連接。
 while True: try: ws = websocket.create_connection('wss://api.upbit.com/websocket/v1') # Send subscription requests and handle data except websocket.WebSocketException as e: print(f'WebSocket error: {e}') time.sleep(5) # Wait for 5 seconds before retrying
處理WebSocket Ping/Pong ：UPBIT的Websocket服務器可能會發送PING消息以保持連接的活力。確保您的客戶用乒乓球響應這些ping，以維持連接。
從市場數據中取消訂閱
如果您不再需要接收某些數據，則可以退訂。這有助於管理數據流並減少不必要的網絡流量。
 
發送一個退訂請求：類似於訂閱，您需要發送JSON-Formatted的退訂請求。例如，要取消訂閱BTC/KRW對訂單，您將發送：
 {
 'type'：“退訂”，
 “頻道”：[
 
{ 'name': 'orderbook', 'symbols': ['KRW-BTC'] }
這是給出的
}

• 使用python發送退縮請求：使用ws.send()方法發送退縮請求。

 unsubscription = {
 'type': 'unsubscribe',
 'channels': [ { 'name': 'orderbook', 'symbols': ['KRW-BTC'] }

這是給出的
}
ws.send（json.dumps（取消訂閱））

關閉WebSocket連接

使用WebSocket連接完成後，正確關閉它以釋放資源很重要。

• 關閉連接：使用ws.close()方法關閉WebSocket連接。

 ws.close()

常見問題

問：我可以立即訂閱多個市場嗎？

答：是的，您可以通過在訂閱請求中包含多個符號來訂閱多個市場。例如，要訂閱BTC/KRW和ETH/KRW訂單書，您將發送：

 {
 'type': 'subscribe',
 'channels': [ { 'name': 'orderbook', 'symbols': ['KRW-BTC', 'KRW-ETH'] }

這是給出的
}

問：如何使用UPBIT的Websocket接口處理速率限制？

答：UPBIT的Websocket接口沒有像RESTFUL API這樣的明確速率限制。但是，為了避免淹沒服務器，您應該有效地管理訂閱和數據處理。如果遇到問題，請考慮減少訂閱數量或實施退縮策略。

問：是否可以通過相同的Websocket連接接收貿易和訂購書籍數據？

答：是的，您可以通過相同的Websocket連接訂閱多種類型的數據。例如，要獲得BTC/KRW的貿易和訂單數據數據，您將發送：

 {
 'type': 'subscribe',
 'channels': [ { 'name': 'orderbook', 'symbols': ['KRW-BTC'] }, { 'name': 'trade', 'symbols': ['KRW-BTC'] }

這是給出的
}

問：如何確保我的Websocket連接在長期內保持穩定？

答：為了確保穩定性，請實現重新連接邏輯以處理斷開連接，管理Websocket PING/PONG消息以保持連接生存，並監視應用程序的性能以避免資源耗盡。