Coinbase Pro API 入門指南

Coinbase Pro API (現已更名為 Advanced Trade API) 是一個強大的工具，允許開發者和交易者通過編程方式與 Coinbase Pro (現已更名為 Advanced Trade) 交易所進行交互。它超越了簡單的網頁界面操作，提供了自動化交易、數據分析和自定義交易策略的可能性。本文旨在為初學者提供一個關於 Coinbase Pro API 的全面介紹，涵蓋從基礎概念到實際應用的各個方面。

1. 什麼是 API？

API (Application Programming Interface) 應用程式編程接口，是軟體應用程式之間相互通信的一種方式。想像一下你身處餐廳，菜單就是 API。你（應用程式）通過菜單（API）向服務員（伺服器）發出請求（例如，點一份披薩），服務員將請求傳遞給廚房（交易所），廚房準備好披薩後，服務員再將披薩（數據）送到你這裡。

在加密貨幣交易中，API 允許你編寫代碼來執行各種操作，例如：

獲取市場數據，如價格、交易量、訂單簿等。
下達買入和賣出訂單。
管理帳戶餘額和交易歷史。
監控市場變化並觸發自動化交易。

2. Coinbase Pro API 的優勢

相較於手動交易或使用其他交易工具，Coinbase Pro API 提供了許多優勢：

**自動化交易:** 可以編寫程序自動執行交易策略，無需人工干預。這對於高頻交易 (High-Frequency Trading, HFT) 或套利策略尤為重要。
**速度和效率:** API 交易速度更快，可以更快地響應市場變化。
**可擴展性:** 可以根據需要擴展你的交易策略，處理大量的交易數據。
**數據分析:** 可以輕鬆地獲取和分析市場數據，以便做出更明智的交易決策。結合技術分析，可以發現潛在的交易機會。
**自定義:** 可以根據自己的需求定製交易策略和界面。
**降低人為錯誤:** 自動化交易減少了手動操作帶來的錯誤風險。

3. Coinbase Pro API 的類型

Coinbase Pro API 主要提供以下幾種接口：

**REST API:** 基於 HTTP 請求的 API，易於理解和使用。它使用 JSON 格式進行數據交換，適合大多數基本的交易需求。它是初學者的首選 API 類型。
**WebSocket API:** 提供實時市場數據流。它使用雙向通信，允許你訂閱特定事件，並在事件發生時立即接收通知。對於需要實時數據更新的應用，例如構建實時圖表或執行閃電交易，WebSocket API 是理想選擇。
**FIX API:** 金融信息交換協議 (Financial Information eXchange)，是一種高速、低延遲的協議，主要用於機構投資者。它比 REST 和 WebSocket 更複雜，但性能更高。

4. 開發環境準備

在開始使用 Coinbase Pro API 之前，你需要準備以下工具和環境：

**Coinbase Pro 帳戶:** 你需要一個已驗證的 Coinbase Pro 帳戶。
**API 密鑰:** 在 Coinbase Pro 帳戶設置中生成 API 密鑰。 API 密鑰包括一個 API Key 和一個 API Secret，用於身份驗證。 **務必妥善保管你的 API Secret，切勿泄露給他人。**
**程式語言:** 選擇一種你熟悉的程式語言，例如 Python、JavaScript、Java 或 C++。
**編程環境:** 安裝必要的開發工具和庫，例如 IDE (Integrated Development Environment) 和 HTTP 客戶端庫。
**API 文檔:** 仔細閱讀 Coinbase Pro API 的官方文檔，了解 API 的各個接口和參數。 [1](https://developers.coinbase.com/api/v2)

5. API 密鑰的管理與安全

API 密鑰是訪問你的 Coinbase Pro 帳戶的憑證，因此必須採取必要的安全措施來保護它們：

**限制權限:** 在創建 API 密鑰時，只授予必要的權限。例如，如果只需要獲取市場數據，則不要授予交易權限。
**存儲安全:** 將 API Secret 存儲在安全的地方，例如環境變量或加密文件中。不要將其直接硬編碼到你的代碼中。
**定期輪換:** 定期更換 API 密鑰，以降低被盜用的風險。
**IP 白名單:** 限制 API 密鑰只能從特定的 IP 地址訪問。
**監控活動:** 定期監控 API 密鑰的使用情況，以檢測任何異常活動。

6. 使用 REST API 獲取市場數據

以下是一個使用 Python 和 REST API 獲取比特幣 (BTC-USD) 價格的示例：

```python import requests

替換為你的 API Key 和 API Secret

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

Coinbase Pro API endpoint

url = "https://api.pro.coinbase.com/products/BTC-USD/ticker"

發送 HTTP 請求

response = requests.get(url)

檢查響應狀態碼

if response.status_code == 200:

   # 解析 JSON 响应
   data = response.json()

   # 提取价格
   price = data["price"]

   # 打印价格
   print(f"比特币 (BTC-USD) 的当前价格为：{price}")

else:

   print(f"请求失败，状态码：{response.status_code}")

```

這段代碼使用了 `requests` 庫來發送 HTTP GET 請求到 Coinbase Pro API 的 `/products/BTC-USD/ticker` 端點，該端點返回比特幣 (BTC-USD) 的最新價格信息。

7. 使用 REST API 下達交易訂單

以下是一個使用 Python 和 REST API 下達限價買單的示例：

```python import requests import hashlib import hmac import time import base64

替換為你的 API Key 和 API Secret

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

Coinbase Pro API endpoint

url = "https://api.pro.coinbase.com/orders"

交易參數

product_id = "BTC-USD" side = "buy" order_type = "limit" quantity = "0.01" # 購買量 price = "30000" # 限價

創建請求體

data = {

   "product_id": product_id,
   "side": side,
   "order_type": order_type,
   "quantity": quantity,
   "price": price

}

創建簽名

timestamp = str(int(time.time())) message = timestamp + "POST" + "/orders" + data hmac_obj = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256) signature = base64.b64encode(hmac_obj.digest()).decode('utf-8')

設置請求頭

headers = {

   "CB-VERSION": "2018-03-22",
   "CB-ACCESS-KEY": api_key,
   "CB-ACCESS-SIGN": signature,
   "CB-ACCESS-TIMESTAMP": timestamp

}

發送 HTTP 請求

response = requests.post(url, headers=headers, json=data)

檢查響應狀態碼

if response.status_code == 200:

   # 解析 JSON 响应
   data = response.json()

   # 打印订单 ID
   print(f"订单 ID：{data['id']}")

else:

   print(f"请求失败，状态码：{response.status_code}")
   print(response.text)

```

這段代碼演示了如何使用 REST API 下達一個限價買單。請注意，在下達交易訂單之前，你需要計算並添加正確的簽名，以確保請求的安全性。簽名計算過程涉及到使用 API Secret 對請求消息進行加密。務必理解交易訂單類型，選擇合適的訂單類型。

8. 使用 WebSocket API 實時獲取市場數據

WebSocket API 允許你訂閱特定事件，並在事件發生時立即接收通知。以下是一個使用 Python 和 WebSocket API 訂閱 BTC-USD 交易數據的示例：

```python import websocket import json

Coinbase Pro WebSocket API endpoint

url = "wss://ws-feed.pro.coinbase.com"

WebSocket 參數

product_id = "BTC-USD" channels = [f"ticker", f"level2", f"trades"]

定義 WebSocket 消息處理函數

def on_message(ws, message):

   data = json.loads(message)
   print(data)

定義 WebSocket 連接建立函數

def on_open(ws):

   subscribe_message = {
       "type": "subscribe",
       "product_id": product_id,
       "channels": channels
   }
   ws.send(json.dumps(subscribe_message))

創建 WebSocket 連接

ws = websocket.WebSocketApp(url, on_open=on_open, on_message=on_message) ws.run_forever() ```

這段代碼創建了一個 WebSocket 連接到 Coinbase Pro WebSocket API，並訂閱了 BTC-USD 的 ticker、level2 和 trades 數據流。每次收到新的市場數據時，`on_message` 函數會被調用，並列印數據。理解訂單簿對於分析Level2數據至關重要。

9. 風險管理與最佳實踐

在使用 Coinbase Pro API 進行交易時，務必注意以下風險管理和最佳實踐：

**測試環境:** 在將你的交易策略部署到真實帳戶之前，先在測試環境中進行充分的測試。 Coinbase Pro 提供了一個測試環境 (sandbox)，可以模擬真實交易環境。
**資金管理:** 合理分配資金，設置止損單和止盈單，以控制風險。學習倉位管理策略。
**錯誤處理:** 編寫健壯的代碼，處理各種可能的錯誤情況，例如 API 連接失敗、訂單失敗等。
**監控和日誌:** 監控 API 的使用情況，並記錄所有交易活動，以便進行審計和分析。
**了解市場:** 深入了解加密貨幣市場，並制定合理的交易策略。掌握技術指標和量價分析技巧。
**安全第一:** 始終將 API 密鑰的安全放在首位。

10. 進一步學習

**Coinbase Pro API 文檔:** [2](https://developers.coinbase.com/api/v2)
**Coinbase Pro Developer Community:** [3](https://www.coinbase.com/developer)
**GitHub 上的 Coinbase Pro API 示例代碼:** 搜索 "Coinbase Pro API" 可以在 GitHub 上找到許多開源示例代碼。
**在線教程和課程:** 許多在線平台提供關於 Coinbase Pro API 的教程和課程。

平台	期貨特點	註冊
Binance Futures	槓桿高達125倍，USDⓈ-M 合約	立即註冊
Bybit Futures	永續反向合約	開始交易
BingX Futures	跟單交易	加入BingX
Bitget Futures	USDT 保證合約	開戶
BitMEX	加密貨幣交易平台，槓桿高達100倍	BitMEX

Coinbase Pro API

目次