幣安 API key 管理與吊銷:開發者的 10 條基線

幣安 API key 怎麼管理?許可權最小化、IP 白名單、定期輪換、緊急吊銷 10 條基線一次說清。

發布於 2026-07-12 · 約 6 分鐘 · 安全設定

「我的 API key 被人拿走了會怎樣」是每個量化開發者都問過的問題。直接答標題:API key 洩露的後果取決於許可權配置,配好 10 條基線的賬戶,即使 key 被盜最多損失單次撮合手續費;沒配好的賬戶,可能在 5 分鐘內被清空。BiabaDev 把 10 條基線整理成清單,覆蓋從建立到吊銷的完整生命週期。管理入口在 幣安官網。

一、10 條基線概覽

基線 目的
1 許可權最小化
2 禁止提現許可權
3 IP 白名單
4 定期輪換
5 環境隔離
6 儲存加密
7 日誌留痕
8 異常告警
9 緊急吊銷
10 事後審計

A:10 條基線中最重要的是第 2 與第 3 條,直接決定洩露後損失上限。

二、基線 1:許可權最小化

2.1 許可權分類

Binance API 許可權分為:

  1. 讀取(Read Only)
  2. 現貨交易
  3. 保證金交易
  4. 期貨交易
  5. 提現

2.2 按需勾選

A:絕大多數量化策略只需要「讀取 + 現貨」。多餘許可權一律不開。

2.3 許可權組合示例

場景 建議許可權
只讀監控 Read Only
現貨策略 Read + Spot
期貨策略 Read + Futures
套利 Read + Spot + Margin

三、基線 2:禁止提現許可權

3.1 提現許可權的極端風險

開啟提現許可權的 API key 一旦洩露,攻擊者可以直接轉走資產。BiabaDev 從未見過合法場景需要開啟此許可權。

3.2 預設關閉

建立 API key 時,提現許可權預設關閉。請務必不要主動開啟。

3.3 提現走人工

若確實需要提現,透過網頁或 App 手工操作。API 提現不值得冒險。參考 白名單。

四、基線 3:IP 白名單

4.1 繫結伺服器 IP

建立 API key 時勾選「限制到指定 IP」,填入伺服器公網 IP。

4.2 多 IP 場景

若策略跑在多臺伺服器,可新增多個 IP。BiabaDev 建議:

  1. 生產服 IP 單獨 key。
  2. 備用服 IP 單獨 key。
  3. 開發機不使用生產 key。

4.3 雲環境的挑戰

雲環境下 IP 可能變動。可用 NAT 閘道器固定出口 IP,或用彈性 IP。

五、基線 4:定期輪換

5.1 輪換頻率

BiabaDev 建議:

  1. 生產 key 每 90 天輪換一次。
  2. 開發 key 每 30 天輪換一次。
  3. 疑似洩露立即輪換。

5.2 無縫輪換

  1. 建立新 key。
  2. 部署到伺服器。
  3. 觀察 24 小時。
  4. 吊銷舊 key。

5.3 記錄輪換時間

在內部 wiki 記錄每次輪換時間與理由,方便審計。

六、基線 5-6:環境隔離與儲存加密

6.1 環境隔離

絕不使用同一個 API key 跨環境:

  1. 生產環境專用 key。
  2. 預釋出環境專用 key。
  3. 開發環境專用 key。

6.2 儲存加密

API key 與 Secret 不應明文儲存:

  1. 使用 HashiCorp Vault 或 AWS Secrets Manager。
  2. 或使用系統金鑰環。
  3. 應用啟動時動態讀取。

風險提示:API Secret 一旦洩露到 GitHub 公有倉庫,可能在數分鐘內被掃描並利用。

七、基線 7-8:日誌與告警

7.1 日誌留痕

所有 API 呼叫都應記錄:

  1. 時間戳。
  2. 請求內容(脫敏)。
  3. 響應內容。
  4. 客戶端 IP。

7.2 異常告警規則

BiabaDev 常用告警:

  1. 單分鐘請求數突增。
  2. 出現未預期的下單方向。
  3. 出現從未見過的 IP 呼叫。
  4. 出現許可權錯誤響應。

7.3 告警通道

告警應至少走兩條通道(郵箱 + Slack / 電報),避免單渠道失效。

八、基線 9-10:緊急吊銷與事後審計

8.1 一鍵吊銷

在 幣安官網 API 管理頁面,可一鍵吊銷任意 key。A:吊銷立即生效。

8.2 應急預案

準備一份應急預案:

  1. 檢測到疑似洩露 → 立即吊銷。
  2. 檢查最近交易記錄。
  3. 通知內部安全團隊。
  4. 凍結賬戶提現 24 小時。
  5. 事後寫覆盤報告。

8.3 事後審計

審計要點:

  1. 洩露源頭(GitHub / 日誌 / 伺服器)。
  2. 洩露時長。
  3. 潛在損失。
  4. 改進措施。

九、開發者最佳實踐

9.1 SDK 選擇

優先使用官方 SDK。第三方 SDK 可能引入不必要的日誌洩露。

9.2 請求籤名

Binance API 請求需 HMAC-SHA256 簽名。A:簽名過程不應記錄明文 secret。

9.3 頻率限制

API 有嚴格的呼叫頻率限制。超過會觸發臨時封禁。BiabaDev 建議:

  1. 使用 WebSocket 替代高頻輪詢。
  2. 快取不常變化的資料。
  3. 參考 網路最佳化。

十、常見問答

Q:API key 與 App 登入是同一套賬戶嗎?

A:同一賬戶,但 API 許可權獨立於 UI 許可權。

Q:API key 會不會被 Binance 主動吊銷?

A:會。若檢測到濫用或 90 天未活動,可能被吊銷。

Q:可以透過 API 修改 2FA 嗎?

A:不能。安全相關設定必須透過 UI。參考 2FA 遷移。

Q:SDK 裡出現 401 錯誤怎麼辦?

A:檢查 key 是否吊銷、時間戳是否同步、IP 是否在白名單。

Q:多個策略能否共用一個 key?

A:技術可行,但不建議。A:一策略一 key 有利於隔離風險。

Q:如何測試 key 是否可用?

A:先呼叫只讀介面(如 /api/v3/account)驗證許可權,再進入交易介面。

Q:緊急情況下能否用手機吊銷?

A:可以。App 內 API 管理頁面同樣支援吊銷。

十一、寫在最後

API key 是加密世界裡的「銀行印章」,誰拿到它就有相應許可權。10 條基線不是可選項,而是必修課。絕大多數慘痛案例都可以追溯到「開了提現」「沒配白名單」「明文提交 GitHub」這三個初級錯誤。花 30 分鐘按基線走一遍,就能避免絕大部分風險。管理入口在 幣安官網,日常檢視可用 幣安官方App。

文件釋出於 2026-07-12,下次複測計劃 2026-10-12