Coinbase Pro API 文檔

Coinbase Pro API 文檔：初學者指南

Coinbase Pro API (現在稱為 Coinbase Advanced Trade API) 是一個強大的工具，允許交易者以編程方式訪問 Coinbase Pro 交易所的數據和功能。對於希望構建自動交易機器人、執行大規模訂單或將交易策略集成到現有系統中的加密貨幣交易者來說，它至關重要。本文將為初學者提供一個全面的指南，涵蓋 API 的核心概念、認證、常見用例和最佳實踐。

1. 什麼是 Coinbase Pro API？

Coinbase Pro API 是一組 RESTful API 端點，允許開發者與 Coinbase Pro 交易所進行交互。與手動在 Coinbase Pro 網站上交易不同，API 允許您通過代碼自動執行各種任務，例如：

獲取市場數據：實時價格、訂單簿、交易歷史等。
下單：市價單、限價單、止損單等。
管理帳戶：查看餘額、交易歷史、存款和提款。
訪問歷史數據：用於回測和策略優化。

使用 API 的優勢包括：

**速度：** 自動化交易比手動交易快得多，尤其是在波動性較大的市場中。
**效率：** 自動化可以減少人為錯誤和交易延遲。
**可擴展性：** API 允許您處理大量訂單和數據，而無需手動干預。
**靈活性：** 您可以根據自己的特定需求定製交易策略。

加密貨幣交易所的API是量化交易的基礎。

2. API 認證

在使用 Coinbase Pro API 之前，您需要創建一個開發者帳戶並生成 API 密鑰。以下是步驟：

1. **創建 Coinbase 帳戶：** 如果您還沒有 Coinbase 帳戶，請先創建一個。 2. **訪問開發者頁面：** 登錄 Coinbase 後，訪問 Coinbase Developer Portal。 3. **創建應用：** 點擊「創建應用」並填寫必要的詳細信息，例如應用名稱和回調 URL (可選)。 4. **生成 API 密鑰：** 創建應用後，您將獲得一個 API 密鑰和一個 API 密鑰短語。 **務必安全地保存這些密鑰，因為它們是訪問您 Coinbase 帳戶的唯一憑證。** 不要將密鑰分享給任何人或將其存儲在不安全的位置。 5. **權限管理：** 在創建應用時，您可以指定 API 密鑰的權限。謹慎選擇權限，只授予應用程式執行其所需的操作的權限。例如，如果您的應用只需要讀取市場數據，則不需要授予其下單權限。

API 密鑰類型

Coinbase Pro API 提供多種 API 密鑰類型，每種類型都具有不同的權限：

API 密鑰類型
類型	描述	權限	API 密鑰	用於身份驗證和授權。	讀取、下單、取消訂單、管理帳戶	API 密鑰短語	與 API 密鑰一起用於簽名請求。	同 API 密鑰	OAuth 2.0 客戶端 ID	用於 OAuth 2.0 授權流程。	僅用於 OAuth 應用	OAuth 2.0 客戶端密鑰	用於 OAuth 2.0 授權流程。	僅用於 OAuth 應用

3. API 端點概覽

Coinbase Pro API 提供了一系列端點，用於訪問不同的功能。以下是一些常用的端點：

**/products：** 獲取可交易產品的列表。交易對
**/products/{product-id}/ticker：** 獲取特定產品的實時價格信息。技術指標
**/products/{product-id}/book：** 獲取特定產品的訂單簿信息。訂單簿分析
**/products/{product-id}/trades：** 獲取特定產品的交易歷史記錄。交易量分析
**/accounts：** 獲取您的帳戶列表。
**/accounts/{account-id}/balance：** 獲取特定帳戶的餘額。
**/orders：** 下單。訂單類型
**/orders/{order-id}：** 獲取特定訂單的信息。
**/orders/{order-id}/cancel：** 取消特定訂單。

完整的 API 文檔可以在 Coinbase Advanced Trade API Documentation 中找到。

4. 常見用例與代碼示例 (Python)

以下是一些使用 Coinbase Pro API 的常見用例以及相應的 Python 代碼示例 (使用 `requests` 庫):

4.1 獲取比特幣 (BTC-USD) 的實時價格

```python import requests

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET" product_id = "BTC-USD"

url = f"https://api.pro.coinbase.com/products/{product_id}/ticker"

headers = {

   'CB-VERSION': '2018-03-22',
   'CB-ACCESS-KEY': api_key,
   'CB-ACCESS-SIGN': "YOUR_SIGNATURE" # 需要使用 API 密钥短语生成签名

}

response = requests.get(url, headers=headers)

if response.status_code == 200:

   data = response.json()
   price = data['price']
   print(f"BTC-USD 的当前价格为: {price}")

else:

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

```

- 注意：** `YOUR_SIGNATURE` 需要使用 HMAC-SHA256 算法根據 API 密鑰短語、時間戳和請求路徑生成。 API 簽名這涉及到對請求進行安全簽名，以防止未經授權的訪問。

4.2 下單 (限價單)

```python import requests import time

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET" product_id = "BTC-USD" side = "buy" # 或者 "sell" amount = 0.01 # 購買數量 price = 30000 # 限價

timestamp = str(int(time.time())) message = f"{timestamp}{product_id}sidelimitamount{price}" signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()

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

headers = {

   'CB-VERSION': '2018-03-22',
   'CB-ACCESS-KEY': api_key,
   'CB-ACCESS-SIGN': signature,
   'Content-Type': 'application/json'

}

data = {

   "product_id": product_id,
   "side": side,
   "type": "limit",
   "amount": amount,
   "price": price

}

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

if response.status_code == 200:

   order_data = response.json()
   print(f"订单已提交，订单 ID: {order_data['id']}")

else:

   print(f"下单失败，状态码: {response.status_code}")
   print(response.text)

```

- 重要提示：** 請根據實際情況修改 API 密鑰、產品 ID、交易方向、數量和價格。務必理解下單風險，並做好風險管理。風險管理

4.3 獲取帳戶餘額

```python import requests

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

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

headers = {

   'CB-VERSION': '2018-03-22',
   'CB-ACCESS-KEY': api_key,
   'CB-ACCESS-SIGN': "YOUR_SIGNATURE" # 需要使用 API 密钥短语生成签名

}

response = requests.get(url, headers=headers)

if response.status_code == 200:

   accounts = response.json()
   for account in accounts:
       print(f"账户 ID: {account['id']}, 币种: {account['currency']}, 可用余额: {account['available']}")

else:

   print(f"获取账户信息失败，状态码: {response.status_code}")

```

5. 最佳實踐

**安全第一：** 始終安全地存儲 API 密鑰，並定期輪換密鑰。
**速率限制：** Coinbase Pro API 具有速率限制，以防止濫用。了解並遵守速率限制，以避免被封禁。 API 速率限制
**錯誤處理：** 編寫代碼以處理 API 錯誤，並適當地記錄和報告錯誤。
**數據驗證：** 驗證從 API 返回的數據，以確保其準確性和完整性。
**回測：** 在實際交易之前，使用歷史數據回測您的交易策略。回測
**監控：** 監控 API 的性能和錯誤，並及時解決問題。
**使用庫：** 考慮使用專門的 Coinbase Pro API 庫，例如 `cbpro` (Python) 或 `node-coinbase-pro` (Node.js)，以簡化開發過程。
**了解市場：** 在進行任何交易之前，充分了解您所交易的加密貨幣和市場。市場分析
**資金管理：** 始終進行適當的資金管理，以限制您的損失。資金管理策略

6. 進階主題

**WebSockets：** 使用 WebSockets 實時接收市場數據。 WebSocket API
**OAuth 2.0：** 使用 OAuth 2.0 授權用戶代表您訪問 Coinbase Pro API。
**高級訂單類型：** 探索各種高級訂單類型，例如止損單、止盈單和追蹤止損單。高級訂單類型
**算法交易：** 開發複雜的算法交易策略。算法交易
**量化交易：** 結合技術分析、統計建模和自動化執行進行量化交易。量化交易策略
**高頻交易：** 理解高頻交易的挑戰和機遇（需要極高的技術水平和基礎設施）。高頻交易
**套利交易：** 利用不同交易所的價格差異進行套利交易。套利交易

7. 資源連結

希望本指南能幫助您開始使用 Coinbase Pro API。請記住，API 是一個強大的工具，但它需要仔細的規劃、開發和測試。祝您交易順利！

🚀 在币安期货享受 10% 的交易返现

立即在币安（Binance）开始你的加密货币期货交易之旅 —— 全球最受信赖的加密交易平台。

✅ 终身 10% 手续费折扣
✅ 高达 125 倍杠杆 交易主流期货市场
✅ 高流动性、极速执行与移动交易支持

利用先进工具和风险控制功能 —— 币安是你认真交易的首选平台。

立即开始交易

📈 Premium Crypto Signals – 100% Free

🚀 Get trading signals from high-ticket private channels of experienced traders — absolutely free.

✅ No fees, no subscriptions, no spam — just register via our BingX partner link.

🔓 No KYC required unless you deposit over 50,000 USDT.

💡 Why is it free? Because when you earn, we earn. You become our referral — your profit is our motivation.

🎯 Winrate: 70.59% — real results from real trades.

We’re not selling signals — we’re helping you win.

Join @refobibobot on Telegram

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

Coinbase Pro API 文檔

目次