幣安 API 是什麼？唯讀、交易與提領權限的安全設定
先決定工具需要讀資料還是能操作資產，再建立金鑰。整理幣安 API 用途、權限表與外洩後的處理順序。
文章目錄 按問題快速跳轉
幣安 API 是讓程式與平台交換資料、執行指定操作的介面。查看部分公開行情不需要帳戶金鑰；同步個人餘額與交易紀錄則需要適當授權。初次接記帳工具，重點是只給必要的讀取權限，不因「連線失敗」就把交易和提領一起打開。
公開行情和個人帳務的差別
市場價格、委託簿等公開資料，與你的帳戶餘額、訂單、交易歷史屬於不同介面。幣安開發文件依端點標示安全類型：例如公開資料可為 NONE，個人資料涉及 USER_DATA，下單涉及 TRADE。
API Key 是辨識及授權的一部分，Secret Key 或私鑰則用於相應的請求簽署。它們不是登入密碼，也不是錢包助記詞；卻同樣需要保密。能取得金鑰並符合權限條件的程式，可能在你沒有逐筆手動確認時操作帳戶。
唯讀、交易、提領權限各能做什麼？
| 權限用途 | 典型需求 | 要承擔的風險 |
|---|---|---|
| 讀取個人資料 | 彙總資產、同步成交、記帳 | 持倉與交易隱私可能外洩 |
| 交易 | 依已授權產品送出或管理訂單 | 錯單、惡意交易及交易損失 |
| 提領 | 透過支援的端點申請資產轉出 | 資產離開帳戶的直接風險 |
不同產品還可能分成現貨、槓桿、合約或轉帳等權限，不能只靠工具名稱判斷。關閉提領不等於沒有風險：如果仍能交易，錯誤訂單、流動性不足與反覆成交都可能使資產減少。
建立前，先把用途寫成一句話
例如「每天同步現貨成交到自己的記帳表」。由這句話反推，只需要查詢所需資料，不需要下單或提領。官方建立流程要求帳戶完成相應啟用、身分驗證及雙重驗證；實際可用選項以自己的帳戶頁為準。
- 從官方網站登入，前往帳戶的 API 管理。
- 為每個用途建立可辨識名稱，避免多個工具共用同一把金鑰。
- 選擇工具實際支援的金鑰類型，完成帳戶驗證。
- 逐項檢查權限與 IP 限制，再接入已確認的工具。
- 記錄用途、建立日期及停用位置，方便之後清理。
HMAC、RSA、Ed25519 先懂保管差異
HMAC 類型由系統提供 API Key 與 Secret Key；RSA、Ed25519 使用自行產生的公私鑰組，向平台提供公鑰，私鑰留在自己管理的環境。公鑰可用來驗證簽署，並不代表可以公開 API Key 或私鑰。
不要把完整憑證貼到群聊、客服訊息、文章截圖或公開程式碼。若使用第三方工具，輸入憑證就意味著授權該工具存取相應資料或功能；先查它如何保存、刪除憑證，以及停用後資料如何處理。
IP 白名單限制誰能連線
官方說明指出，沒有設定 IP 存取限制的 HMAC 金鑰只能保留讀取權限；開啟提領權限則必須加入 IPv4 存取限制。初學者不應為了解除報錯，直接取消安全控制或改成全部開放。
白名單應填寫實際執行請求環境的對外 IP。例如工具在雲端伺服器執行，填家中電腦 IP 通常無法符合限制。請向工具確認固定出口位址；若位址改變，先確認變更原因，再調整設定。
用一個唯讀任務檢查串接結果
假設只整理最近七天現貨紀錄，先確認能讀到正確帳戶及日期，再抽查兩筆成交：交易對、買賣方向、數量和手續費是否與帳戶一致。顯示不同時，先查時區、產品帳戶與資料範圍，不要立刻增加權限。
工具若聲稱查餘額必須開提領，應停下來重新核對。交易功能可先了解官方測試環境與對應文件，本文不提供自動實盤下單程式。費用欄位的讀法可參考幣安費用分類。
懷疑金鑰外洩時，先撤銷存取
從可信任裝置進入官方 API 管理，停用或刪除有疑慮的金鑰，檢查訂單、成交、轉帳和提領紀錄，並透過官方客服回報異常。若帳戶已有未授權活動，依官方流程停用帳戶。刪掉聊天中的文字，無法讓已被複製的金鑰失效。
後續再重新建立所需權限、確認工具與裝置安全，並清理其他不用的金鑰。密碼、驗證器和登入裝置的檢查，見帳戶安全設定。
常見問題
只看行情也要交出 API Key 嗎？
部分公開市場資料不需要。先問工具要用哪個介面，不能只因它要求金鑰就認為必要。
API 能保證交易比較賺嗎？
不能。API 只是執行方式，策略錯誤、程式缺陷、費用與價格變動仍會影響結果；執行得更快也可能更快放大錯誤。
資料來源
資料核對日期：2026 年 11 月 12 日。產品條件與費用可能調整，使用前請核對相關官方頁面。
