如何使用KuCoin API進行交易機器人？ （開發者工具）

認證機制

1. KuCoin API需要為所有私有端點產生HMAC-SHA256簽章。簽章源自時間戳、HTTP 方法、端點路徑和可選請求正文的串連。

2. 每個請求必須包含三個標頭： KC-API-KEY 、 KC-API-TIMESTAMP和KC-API-SIGN 。時間戳記必須在KuCoin伺服器時間的5秒以內。

3. API金鑰對必須在KuCoin使用者介面的API管理下產生。權限應僅限於必要的範圍，例如「交易」、「帳戶」或「提款」。

4. 密鑰絕不會透過線路傳輸。它們保留在機器人環境中本地，僅用於簽署傳出請求。

5. 預設情況下，對新建立的 API 金鑰強制執行 IP 白名單。開發者必須提前註冊可信任IP，避免401未授權回應。

訂單生命週期管理

1. 下訂單使用POST /api/v1/orders端點，其中包含交易品種、邊（買入/賣出）、類型（限價/市價/停損）以及大小或價格等參數。

2、市價單只需要尺寸和邊長；限價單同時規定價格和尺寸。停損單引入了額外的字段，例如 stopPrice 和 stop。

3. 活躍訂單可以透過GET /api/v1/orders?status=active查詢，傳回包含訂單 ID、狀態、已成交尺寸和剩餘尺寸的分頁結果。

4. 取消單一訂單使用DELETE /api/v1/orders/{order-id} ，批次取消針對多個 ID 使用DELETE /api/v1/orders?symbol=BTC-USDT 。

5. 透過 WebSocket 來源或輪詢GET /api/v1/fills端點來追蹤訂單執行狀態，該端點傳回交易歷史記錄，包括費用金額和時間戳記。

市場數據整合

1. 透過GET /api/v1/market/orderbook/level2_20?symbol=BTC-USDT檢索公共股票數據，提供前 20 個買入/賣出水準的價格、規模和序號。

2. 透過 KuCoin 的 WebSocket v2 通道/market/ticker:{symbol}支援即時更新，用戶端使用包含 topic 和 privateChannel 標誌的 JSON 訊息進行訂閱。

3. 歷史K線資料透過GET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200取得，支援間隔從1分鐘到1天。

4. 交易品種清單和交易對詳細資訊可在GET /api/v2/symbols獲取，包括 baseCurrency、quoteCurrency、priceIncrement 和 minSize 約束。

5. 深度快照包含啟用增量同步的序號。客戶必須驗證序列連續性，以避免錯過更新或過時的訂單簿狀態。

速率限制和錯誤處理

1. KuCoin執行嚴格的速率限制：標準API金鑰上公用端點每秒100個請求，私有端點每秒20個請求。

2. 超出限制會觸發 HTTP 429 回應，其中 Retry-After 標頭指示強制退避持續時間（以毫秒為單位）。

3. 常見錯誤碼包括400（參數無效）、401（認證失敗）、403（權限不足）、404（符號未找到）。

4. 所有錯誤回應均包含標準化 JSON 主體，其中包含代碼、訊息，有時還包含建議字段，例如{'code':'400100','msg':'Invalid symbol'} 。

5.下單需要冪等金鑰，防止重複提交；它們必須是在KC-API-REQ-ID標頭中發送的唯一 UUID。

常見問題解答

Q：我可以在多個機器人實例中使用相同的 API 金鑰嗎？ A：可以，但是並發請求超過速率限制會導致限流。如果共享密鑰遭到洩露，也會增加安全風險。

Q：即使時間戳記和密碼正確，為什麼我的簽章請求仍回傳「無效簽章」？答：最常見的原因是字串規範化不正確－元件之間缺少換行符、請求正文的 UTF-8 編碼不正確或預雜湊字串中的尾隨空格。

Q：WebSocket 連線是否支援狀態重新同步的重新連線？答：是的，KuCoin在每個訊息中都會提供序號。重新連接後，客戶端應請求新快照並丟棄序號低於上次處理的訊息的任何訊息。

Q：保證金或期貨交易是否透過相同的 REST API 支援？答：不需要。保證金和期貨作業需要單獨的 API 庫： https://api.kucoin.com/api/v1/margin和https://futures.kucoin.com/api/v1/contracts/active ，每個庫都有不同的驗證和端點。