如何使用Bithumb的API？

使用Bithumb的API可以增強交易策略並自動化流程；本指南涵蓋註冊，API密鑰設置以及有效的第一個API調用。

2025/04/18 20:49

使用Bithumb的API可以顯著增強您的交易策略，自動化流程和訪問實時數據。在本指南中，我們將引導您瀏覽有效使用Bithumb的API的步驟，從而涵蓋從註冊到執行第一個API呼叫的所有內容。

註冊和設置API密鑰

在使用Bithumb的API之前，您需要註冊一個帳戶並設置API密鑰。您可以做到這一點：

• 訪問Bithumb網站並註冊一個新帳戶，如果您還沒有一個帳戶。您需要提供個人詳細信息並完成驗證過程。
• 登錄您的BitHumb帳戶。導航到API管理部分，通常在帳戶設置或安全設置下找到。
• 創建一個新的API鍵。將提示您輸入API鍵的名稱，該名稱可幫助您在需要時管理多個鍵。請確保根據您打算使用API​​來啟用必要的權限。
• 生成API鍵。您將收到一個API密鑰和一個API秘密。這些對於對您的API請求進行身份至關重要，因此請確保它們安全。

了解Bithumb的API端點

Bithumb的API分為幾個端點，每個端點都有特定目的。這是您應該知道的一些關鍵端點：

• 公共API ：這些端點不需要身份驗證，並且用於獲取市場數據，例如股票信息，訂單書和交易歷史記錄。
• 私有API ：這些端點需要身份驗證，並允許您執行諸如下訂單，取消訂單和管理帳戶餘額之類的操作。

進行第一個API電話

要進行第一個API調用，您需要使用Python，JavaScript或任何其他支持HTTP請求的語言等編程語言。這是使用Python的分步指南：

• 安裝必要的庫。您需要requests提出HTTP請求和hmac來簽署請求。您可以使用PIP安裝它們：

 pip install requests

• 在您的Python腳本中導入庫：

 import requests
 import hmac
 import hashlib
 import time

• 設置您的API憑據：

 api_key = 'YOUR_API_KEY'
 api_secret = 'YOUR_API_SECRET'

• 構建API調用。讓我們使用公共API獲取Bitcoin（BTC）的股票信息：

 endpoint = 'https://api.bithumb.com/public/ticker/BTC'
 response = requests.get(endpoint)
 print(response.json())

• 對於私人API電話，您需要簽署請求。這是如何下訂單的一個示例：

 endpoint = 'https://api.bithumb.com/trade/place'
 params = { 'order_currency': 'BTC', 'payment_currency': 'KRW', 'units': '0.001', 'price': '1000000', 'type': 'bid'

}
params ['endpoint'] =端點
nonce = str（int（time.time（） * 1000））
params ['nonce'] = nonce

創建簽名

query_string ='＆'。 join（[f'{k} = {v}'for K，v in sorted（params.items（）））
signature = hmac.new（api_secret.encode（'utf-8'），query_string.encode（'utf-8'），hashlib.sha512）.hexdigest（）

標題= {

'Api-Key': api_key, 'Api-Sign': signature, 'Content-Type': 'application/x-www-form-urlencoded'

}

響應= requests.post（端點，data = params，headers =標題）
打印（response.json（））

處理錯誤和響應

使用Bithumb的API時，正確處理錯誤和解析響應很重要。您可以做到這一點：

• 檢查響應的狀態代碼。 200個狀態代碼表示成功，而其他代碼表示錯誤。
• 解析JSON響應。 Bithumb的API以JSON格式返回數據，您可以使用Python的json模塊輕鬆解析數據。

 import json如果響應。 STATUS_CODE== 200：




data = response.json() if data['status'] == '0000': print('Success:', data) else: print('Error:', data['message'])
別的：
 
print('HTTP Error:', response.status_code)
使用Bithumb的Websocket API
對於實時數據，BitHumb提供了Websocket API。這是您可以使用Python連接到它的方式：
 
安裝websocket-client庫：
 pip install websocket-client
連接到Websocket ：
 import websocket
進口JSON
 
def on_message（WS，消息）：
 
data = json.loads(message) print(data)
 DEF ON_ERROR（WS，錯誤）：
 
print(error)
 def on_close（WS）：
 
print('### closed ###')
 def on_open（WS）：
 
print('### opened ###')
 websocket.enabletrace（true）
 ws = websocket.websocketapp（'wss：//pubwss.bithumb.com/pub/ws'，
 
 on_message=on_message, on_error=on_error, on_close=on_close)
 ws.on_open = on_open
 ws.run_forever（）

使用Bithumb的API的最佳實踐

為了確保您有效，安全地使用Bithumb的API，請考慮以下最佳實踐：

• 保護您的API鍵。切勿共享您的API鍵或將它們存儲在版本控制系統中。使用環境變量或安全庫存儲它們。
• 費率限制。請注意Bithumb的速率限制，以免受到API訪問的限制。實施重試機制，並以指數向後進行處理率限制錯誤。
• 錯誤處理。始終在代碼中包含強大的錯誤處理以優雅地處理API失敗。
• 測試。在將代碼部署到生產之前，請在沙箱或測試環境中徹底測試它，以確保其按預期工作。

常見問題

問：我可以使用Bithumb的API進行自動交易嗎？

答：是的，Bithumb的API通過其私人端點支持自動交易，使您可以按編程方式下訂單，取消訂單並管理您的帳戶餘額。

問：有關Bithumb API的數據多久更新一次？

答：公共API端點，例如股票和訂單數據數據，通常是實時更新的，而私有API端點可能會根據您的帳戶的活動具有不同的更新頻率。

問：我可以在BitHumb上創建的API鍵的數量有限制嗎？

答：BitHumb可能會限制您可以創建每個帳戶的API鍵的數量。您應該檢查API文檔或聯繫BitHumb支持以獲取特定詳細信息。

問：我可以使用Bithumb的API獲取歷史數據嗎？

答：Bithumb的API主要提供實時數據。對於歷史數據，您可能需要使用第三方服務或手動收集和存儲數據。