如何設定 Bitstamp API 金鑰以進行自動交易？ （開發者工具）

API金鑰產生流程

1. 使用經過驗證的憑證透過https://www.bitstamp.net登入您的 Bitstamp 帳戶。

2. 導覽至右上角的使用者選單並選擇“帳戶設定”，然後點擊左側邊欄中的“API 存取”。

3. 點選“建立新API金鑰”，輸入描述性標籤，例如“TradingBot-Prod”，並選擇嚴格限制為“餘額”、“使用者交易”、“開倉訂單”、“取消訂單”和“下訂單”的權限。

4. 透過輸入您的交易伺服器或雲端執行個體的靜態 IPv4 位址來啟用 IP 位址限制；僅在使用動態 IP 處理進行本機部署時才保留空白。

5. 使用您的雙重認證裝置確認建立； Bitstamp 立即顯示 API 金鑰和秘密金鑰- 在關閉模式之前必須複製這兩個值，因為秘密金鑰永遠不會再次顯示。

安全加固要求

1. 將 API 金鑰和金鑰儲存在版本控制之外的加密環境變數檔案中；切勿將它們直接嵌入原始程式碼或設定檔中。

2. 設立具有零提現能力的專用 Bitstamp 子帳戶，並僅使用用於自動執行的資金為其提供資金。

3. 關閉所有「提幣」、「轉帳」、「帳戶管理」相關權限； Bitstamp 在 API 層強制執行此操作，而不僅僅是 UI 可見性。

4. 使用 Bitstamp 的金鑰撤銷介面每 90 天輪換一次金鑰，並在所有連線的服務中重新部署更新的憑證。

5. 每天監控「API 存取日誌」標籤，以了解意外的請求時間戳記、地理位置或表示憑證洩漏的異常高的呼叫量。

REST 端點集成

1. 所有經過驗證的請求必須包含標頭X-Auth ，其中包含由「 API key : API Secret 」形成的 Base64 編碼字串。

2. 使用端點https://www.bitstamp.net/api/v2/balance/驗證連線；成功的回應傳回帶有「usd_balance」、「btc_balance」和「fee」欄位的 JSON。

3. 要下限價單，請使用表單編碼參數（包括「amount」、「price」和「limit_price」）POST 到https://www.bitstamp.net/api/v2/buy/btcusd/ 。

4. 在每個請求的「timestamp」參數中包含以毫秒為單位的 Unix 時間戳記； Bitstamp 拒絕時間戳相對於伺服器時間早於 30 秒或晚於 30 秒的請求。

5. 透過實作指數退避邏輯來處理 HTTP 429 回應 - Bitstamp 速率限制為每個 API 金鑰每分鐘 100 個請求。

WebSocket即時資料流

1. 使用支援 RFC 6455 的 WebSocket 用戶端連線到wss://ws.bitstamp.net 。

2. 連線後立即發送訂閱訊息： {“event”:“bts:subscribe”,“data”:{“channel”:“live_trades_btcusd”}} 。

3. 解析傳入的 JSON 有效負載，其中包含包含「id」、「price」、「amount」和「microtimestamp」欄位的「data」數組，以取得滴答級執行訊號。

4. 斷開連線時自動重新連接，使用 1.2 至 2.8 秒之間的抖動間隔，以避免 Bitstamp 閘道出現雷群效應。

5. 透過根據預期模式檢查「通道」欄位並丟棄缺少「資料」根物件的任何有效負載來驗證訊息的真實性。

常見問題解答

Q：Bitstamp 是否支援像 Binance 或 OKX 一樣基於簽名的身份驗證？ Bitstamp 不使用 HMAC-SHA256 簽章。它僅依賴 X-Auth 標頭中的 Base64 編碼的 API 金鑰 + 秘密以及嚴格的時間戳驗證。

Q：我可以對 REST 和 WebSocket 連線使用相同的 API 金鑰嗎？是 - Bitstamp 頒發跨兩個傳輸層有效的單一統一金鑰對，無需單獨的範圍或令牌。

Q：如果我的 API 金鑰連續觸發多個 429 錯誤，會發生什麼事？ Bitstamp 可能會暫時限制密鑰長達 15 分鐘；無需手動解鎖，但重複違規可能會導致永久撤銷。

Q：是否有可用於 Bitstamp API 整合的測試網或沙箱環境？否 — Bitstamp 不提供官方暫存環境；開發人員必須使用小額即時訂單，並在初始部署期間仔細監控餘額變更。