如何使用Coinbase API進行交易合同？

Coinbase Advanced Trade API僅支持現貨交易（購買和出售實際加密），而不是期貨或永久合同。

2025/08/12 17:14

了解Coinbase API及其功能

Coinbase API是一種強大的工具，可允許開發人員和交易者與Coinbase的金融服務進行程序互動。儘管Coinbase提供了廣泛的功能，包括現貨交易，錢包管理和價格數據檢索，但至關重要的是要澄清Coinbase目前不支持通過其標準API來支持交易期貨或永久合同。 Coinbase Advanced Trade API的主要重點是現貨交易，這意味著以當前市場價格購買和銷售實際的加密貨幣。

儘管如此，許多用戶還是將Coinbase與Coinbase衍生品或Coinbase International Exchange混淆，這些衍生物是提供期貨交易的獨立實體。這些平台在不同的監管框架和API下運行。如果您的目標是交易期貨或期權等合同，則必須確認您是否正在使用正確的Coinbase附屬服務。目前， Coinbase Advanced Trade API僅支持現貨市場運營，包括限額訂單，市場訂單和加密貨幣對的停止訂單。

要開始使用API，您必須首先在Coinbase Advanced Trade上創建一個帳戶並生成API密鑰。這些密鑰將授予您對交易帳戶的申請訪問，因此必須仔細管理權限至關重要。生成鑰匙時，您可以分配特定的角色，例如“視圖”，“交易”或“轉移”。出於交易目的，請確保啟用“交易”許可。

設置您的Coinbase API鍵

在進行任何交易之前，您需要使用API憑據來驗證您的請求。這是生成和配置密鑰的方法：

• 登錄您的Coinbase Advanced Trade帳戶
• 導航到設置> API
• 單擊+新的API鍵
• 選擇適當的權限： “查看”和“貿易”
• 輸入您的密鑰的名稱（例如，“交易機器人”）
• 完整的兩因素身份驗證（2FA）
• 複製生成的API密鑰，秘密和密碼

安全存儲這些憑證。秘密和密碼僅顯示一次，如果丟失，則無法檢索。切勿在客戶端代碼或公共存儲庫中暴露它們。

一旦擁有鑰匙，就可以開始將它們集成到應用程序中。 API使用HMAC-SHA256身份驗證。每個請求必須包括以下標題：

• CB-ACCESS-KEY ：您的API密鑰
• CB-ACCESS-SIGN ：消息的HMAC簽名
• CB-ACCESS-TIMESTAMP ：請求的UNIX時間戳
• CB-ACCESS-PASSPHRASE ：您設置的密碼

簽名是通過使用您的秘密的時間戳，HTTP方法，請求路徑和身體（如果有）的串聯來生成的。

通過Coinbase API進行現貨交易

儘管不支持合同交易，但您可以使用高級交易API執行現貨交易。這些交易涉及以當前市場價格以當前市場價格交換加密貨幣。要下訂單，您將使用“創建訂單”端點。

這是為BTC-USD下達限額購買訂單的一個示例：

• HTTP方法： POST
• 端點： https://api.coinbase.com/api/v3/brokerage/orders
• 請求主體：

   {
   'client_order_id': 'unique-id-123',
   'product_id': 'BTC-USD',
   'side': 'BUY',
   'order_configuration': {
   'limit_limit_gtc': { 'base_size': '0.001', 'limit_price': '30000.00'

  }
  }
  }

關鍵參數包括：

• client_order_id ：訂單的唯一標識符
• product_id ：交易對（例如，btc-usd）
• side ： “買”或“賣”
• base_size ：交易的加密貨幣量
• limit_price ：您願意支付的最高價格

確保您的帳戶有足夠的美元餘額以購買或BTC餘額進行賣出。根據市場可用性執行訂單，可能部分填寫。

要檢查訂單狀態，請在響應中返回的order_id使用“獲取訂單”端點。您還可以使用具有狀態過濾器的“列表訂單”端點列出所有訂單（打開，填充，取消）。

檢索市場數據並監視價格

成功的交易需要最新的市場信息。 Coinbase API提供了幾個端點來檢索實時和歷史數據。

要獲取最新的最佳出價並要求產品價格：

• 端點： GET /api/v3/brokerage/product/book?product_id=BTC-USD&limit=1
• 響應包括：
  • 最高出價的price和size
  • 最高要求的price和size

對於燭台數據（用於技術分析），請使用：

• 端點： GET /api/v3/brokerage/market/products/BTC-USD/candles
• 查詢參數： type=1_MINUTE ， start=1700000000 ， end=1700003600

這將返回指定時間範圍和間隔的OHLC（開放，高，低，關閉）值。

您還可以通過多個級別檢索訂單書：

• limit=50給出了前50個出價和詢問
• 使用此數據來分析市場深度並預測價格變動

定期輪詢這些端點，您可以構建實時交易儀表板或自動化決策邏輯。

處理錯誤和費率限制

Coinbase API強加了速率限制以防止濫用。對於交易端點，限制通常為每秒10個API密鑰的10請求。超過此結果導致429 Too Many Requests 。為了避免這種情況：

• 在您的重試邏輯中實現指數退回
• 盡可能緩存響應
• 使用Websocket進行實時數據而不是經常進行輪詢

常見錯誤代碼包括：

• 401 Unauthorized ：無效或缺少API憑據
• 403 Forbidden ：權限不足
• 404 Not Found ：無效的產品ID或訂單ID
• 400 Bad Request ：畸形的JSON或無效參數

始終驗證輸入並優雅處理錯誤。例如，在下訂單之前，請檢查是否支持ETH-USD這樣的產品ID。

常見問題

我可以使用API在Coinbase上交易期貨嗎？

不， Coinbase Advanced Trade API不支持期貨或永久合同。僅限於現場交易。期貨交易可在Coinbase衍生產品上使用，該衍生物可能具有單獨的API接口。

Coinbase和Coinbase Advanced Trade API有什麼區別？
Coinbase.com是一個面向消費者的平台，用於用菲亞特購買加密貨幣。 Advanced Trade API是用於自動交易的專業級界面，可為現貨市場，訂單書和定價數據提供程序化訪問。

如何通過API取消打開訂單？

使用DELETE /api/v3/brokerage/orders/{order_id} endpoint。將{order_id}替換為實際訂單標識符。該響應確認如果已經填寫或無效，則可以確認取消或返回錯誤。

使用API鍵進行自動交易安全嗎？

是的，如果遵循最佳實踐。使用強，獨特的密碼詞，將權限限制在需要的內容中，將鑰匙存儲在加密環境中，並避免將它們在腳本中進行硬編碼。考慮使用IP白名單（如果有）。