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

設定 API 憑證

1. 登入您的幣安帳戶並導航至「安全」下的「API 管理」部分。

2. 點選“建立API”，依照您的交易範圍選擇標準API或統一交易API。

3. 指派描述性名稱並啟用 IP 白名單以增強安全性 — 只有受信任的伺服器才能發起請求。

4. 透過電子郵件和 2FA 確認創建，然後安全儲存 API Key 和 Secret Key——頁面刷新後無法再次檢索。

5. 停用未使用的權限，例如“提款”或“保證金轉帳”，以最大限度地減少憑證外洩時的風險。

了解身分驗證流程

1. 每個專用端點都需要使用您的金鑰和規格請求字串產生 HMAC-SHA256 簽章。

2. 時間戳參數必須在 Binance 伺服器時間的 1000 毫秒內同步 - 在簽章之前使用/api/v3/time端點取得準確的伺服器時間。

3. 在 GET 請求的查詢字串或 POST 請求的請求正文中包含簽名以及 X-MBX-APIKEY 標頭中的 API 金鑰。

4. Nonce 值必須是嚴格遞增的整數或毫秒時間戳記－重複使用或跳過值會觸發拒絕。

5. 每個 IP 和 API 金鑰都有速率限制 — 超過這些限制將傳回帶有 Retry-After 標頭的 HTTP 429；在您的機器人中實現指數退避邏輯。

執行現貨訂單操作

1. 使用POST /api/v3/order下限價單、市價單、停損單或止盈單，並具有精確的參數（如交易品種、邊、類型、數量和價格）。

2. 透過設定test=true啟用測試模式，以驗證訂單結構而無需實際執行 - 非常適合整合測試。

3. 使用 clientOrderId 或 orderId 透過GET /api/v3/order取得即時訂單狀態，傳回成交數量、平均價格和目前狀態。

4. 使用DELETE /api/v3/order取消掛單，並提供交易品種和 orderId 或 origClientOrderId。

5. 使用帶有符號和可選限制的GET /api/v3/myTrades取得最近的交易歷史記錄 — 交易按降序時間順序傳回。

管理帳戶資料和餘額

1. 呼叫GET /api/v3/account查詢所有資產餘額，包括現貨錢包的免費、鎖定和總金額。

2. 在啟動買入/賣出邏輯之前，透過檢查餘額陣列並驗證free > 0 來動態過濾資產。

3. 如果利用交叉或逐倉保證金模式，請使用GET /sapi/v1/margin/account監控保證金水準變化。

4. 解析updateTime欄位以偵測過時的餘額快照 - 刷新間隔應與機器人的決策延遲一致。

5. 透過將myTrades中的tradeId與已執行的訂單 ID 相關聯，根據訂單執行情況交叉檢查餘額更新。

常見問題解答

Q：我可以在多個機器人中使用相同的 API 金鑰嗎？答：是的，但它會增加風險面 - 如果一個機器人受到威脅，所有連結的操作都會暴露。偏好每個機器人擁有最小權限的專用金鑰。

Q：為什麼我的簽名請求回傳「無效簽名」？答：最常見的原因是簽章產生期間的字串連線不正確、時脈偏差超過 ±1000ms，或簽章本身在傳送前意外進行 URL 編碼。

Q：WebSocket 串流是否支援即時訂單簿更新？答：是的－連接到wss://stream.binance.com:9443/ws/{symbol}@depth取得原始 L2 訂單簿數據，或在一個連線下對多個交易品種使用組合流。

Q：如何處理 API 停機或 503 回應？答：實施斷路器模式 - 追蹤連續故障，在可設定的持續時間內暫停請求，並僅在透過GET /api/v3/ping成功檢查健康狀況後恢復。