幣安 API key 許可權鎖定|Biabafox 速查

Biabafox 把幣安 API key 的 5 類許可權(讀取/現貨/合約/槓桿/提現)拆開講清楚,給出 IP 白名單速查表 + 高危場景避坑 + 金鑰洩漏 6 步應急流程。

發布於 2026-07-10 · 約 9 分鐘 · 安全設定

API key 是賬號裡最容易洩漏也最難挽回的憑據——直接答案:幣安 API key 的安全原則只有一句話,"能只讀就絕不給交易許可權,能給單一 IP 就絕不給全網訪問,絕不勾選提現許可權除非明確需要且理解風險"。Biabafox 把幣安 API 許可權的 5 大類、IP 白名單機制、7 種高危場景、6 步洩漏應急流程壓縮到一篇速查裡,讓你 30 分鐘建立可復現的 API 安全操作規範。

如果你手上還沒有 API key,可以先到 幣安官網 完成賬戶實名和 2FA,或者透過 下載頁 的 幣安官方App 走一遍安全設定,本文預設你已經完成這些前置。

場景與讀者畫像

  • 適用場景:量化交易、資料分析、行情看板、跨所套利、做市
  • 難度:中高(涉及許可權模型、IP 網段、簽名機制)
  • 估時:單 key 建立 + 許可權規劃 15 分鐘;應急演練 30 分鐘
  • 適合人群:量化使用者、開發者、機構 API 對接、行情工具作者
  • 裝置:一臺穩定 IP 的伺服器 + 一臺管理用 PC
  • 網路:API 端固定公網 IP;管理端能正常訪問 幣安官網
  • 風險等級:高(一旦洩漏可能損失全部資產)
  • 成本:0
  • 替代方案:僅透過 Web/App 手動操作(安全但無法自動化)
  • 常見錯誤:許可權一次給全、無 IP 白名單、把 secret 寫程式碼庫
  • 校驗方法:用只讀 key 嘗試下單應報錯,用限 IP key 從其他 IP 應報錯

5 類許可權速查表

Biabafox 按幣安實際選項把許可權分為 5 類,從最弱到最強:

許可權 能做什麼 洩漏後損失上限 建議啟用場景 推薦配合
讀取 查行情、賬戶餘額、K 線 隱私洩漏 資料分析、行情看板 無需 IP 也可用
現貨交易 下單、撤單、成交 幣被惡意換成低流動性幣 現貨量化 必須 IP 白名單
槓桿交易 借幣、還幣、槓桿下單 觸發爆倉 槓桿策略 必須 IP 白名單
合約交易 U 本位/幣本位合約下單 無風控下滿倉爆倉 合約量化 必須 IP 白名單 + 風控
提現 直接提現到白名單地址 全部資產被轉走 極少數託管場景 強制 IP + 白名單鎖定

A:Biabafox 反覆強調:99% 的量化使用者不需要提現許可權,把這一欄留空就能砍掉 90% 以上的資產風險。即使 secret 洩漏,攻擊者最多在你賬戶裡亂下單,無法把幣轉走。這是 API 安全的第一原則。

許可權組合的三個層次

按用途拆解常見的三種 key 組合:

  1. 只讀 key:僅勾選"讀取",無 IP 白名單也可用。適合行情看板、賬戶餘額顯示
  2. 交易 key:勾選"讀取 + 現貨/合約",必須繫結固定 IP。適合量化機器人
  3. 提現 key:僅在你需要機器人自動從幣安轉到冷錢包時才建,強制 IP + 強制提現白名單鎖定

IP 白名單速查

IP 白名單是 API 安全的第二道鎖,與許可權鎖定同等重要。

IP 配置 支援的 API 許可權 有效期
不配置 IP 僅"讀取"可用 90 天自動過期
配置單個 IP 全部許可權 長期有效
配置多個 IP(逗號分隔) 全部許可權 長期有效
配置 IP 段 不支援 無
配置 IPv6 支援 長期有效

常見部署場景對照

部署位置 推薦 IP 配置 備註
阿里雲/騰訊雲獨立公網 IP 單個固定 IP 最推薦
AWS EIP 單個固定 IP 最推薦
Cloudflare Workers 走出口代理再固定 需中轉
家庭動態 IP DDNS + 每日重新整理 不推薦生產
行動網路 完全不推薦 IP 每幾分鐘變一次

A:Biabafox 的建議:從來不要在沒有固定 IP 的環境部署帶交易許可權的 API key。若臨時測試只需只讀許可權,讀完刪掉。寧可換到有固定 IP 的伺服器再上線,也不要圖便宜跑家裡 PPPoE 撥號 IP。

90 天過期機制

幣安從 2023 年起對無 IP 限制的 key 強制 90 天有效期:

  • 首次建立後 90 天自動禁用(讀取許可權也禁)
  • 到期前 7 天開始郵件提醒
  • 續期時需要重新 2FA 驗證
  • 加了 IP 白名單則無過期時間(推薦做法)

7 種高危場景避坑

Biabafox 覆盤社群 API 洩漏事件,最常見的 7 類:

場景 危險等級 修復方法
把 secret 直接寫入 Git 倉庫 極高 立即刪 key + 環境變數注入
用截圖分享程式碼時露出 API 金鑰 高 立即刪 key + 檢查歷史訊息
在公共 Discord/Telegram 群貼日誌 高 日誌脫敏 + 立即刪 key
用同一 key 給多個策略共享 中 一策略一 key,方便追蹤
無 IP 白名單讓"任何 IP 可訪問" 極高 立即加 IP 或刪 key
勾選提現許可權用於常規量化 極高 立即取消提現許可權
交易 key 存密碼管理器"備註"欄位 中 移至加密備註 + 定期輪換

secret 存放的 3 條硬規則

  1. 絕不入程式碼倉庫(.gitignore 兜底不夠,用 git-secrets 掃描)
  2. 生產環境用環境變數或金鑰管理服務(KMS、Vault)
  3. 本地開發用 .env 檔案,且 .env 嚴禁 push

洩漏應急 6 步流程

一旦懷疑 secret 洩漏,Biabafox 建議按以下順序在 5 分鐘內處置:

步驟 操作 時間預算
1 登入 幣安官網 → API 管理 → 立即禁用可疑 key 30 秒
2 修改賬戶密碼 + 強制所有會話下線 1 分鐘
3 檢查最近 24 小時的下單、劃轉、提現記錄 2 分鐘
4 檢查子賬戶與合約賬戶是否有異常 1 分鐘
5 若有非常規訂單,聯絡幣安客服凍結賬戶 手動
6 覆盤洩漏路徑並加固(IP 白名單、許可權收斂) 事後

A:Biabafox 反覆強調:處置順序是"先禁 key 再排查",不要順序反過來。攻擊者可能正在實時操作,多猶豫 30 秒就是一筆惡意訂單。

事後覆盤的 4 個必查點

  • Git commit 歷史(git log --all -p | grep -i api)
  • 雲盤/郵箱附件搜尋"key"、"secret"
  • 團隊協作工具(Slack、Notion)歷史
  • 本地 shell history、IDE 剪貼簿快取

常見問題

Q1:只讀 key 會不會也洩漏隱私?

A:會。只讀 key 能讀到賬戶餘額、下單歷史、劃轉記錄,這些資料本身對釣魚者有價值。Biabafox 建議:即使是隻讀 key 也要加 IP 白名單。

Q2:幣安支援 HMAC-SHA256 之外的簽名方式嗎?

A:支援。2024 年後幣安推出了 Ed25519 簽名,金鑰長度更短、驗籤更快、抗量子攻擊。Biabafox 認為:新建 key 優先選 Ed25519,尤其是高頻量化場景。

Q3:子賬戶能不能單獨發 API key?

A:可以。子賬戶 API 獨立於主賬戶,許可權也可以細化到子賬戶級別。Biabafox 強烈推薦:把策略資金隔離到子賬戶裡,即使 key 洩漏損失也被限制在子賬戶餘額內。

Q4:如何檢測 API key 是否正在被非法使用?

A:幣安提供 API 呼叫日誌,可以看到最近 30 天每個 key 的呼叫來源 IP、頻率、異常錯誤。建議每週巡檢一次。若發現來源 IP 不是自己的伺服器,立即禁用。

Q5:API 提現許可權和賬戶提現白名單是什麼關係?

A:疊加關係。API 提現許可權只允許提到賬戶級別的提現白名單內的地址。所以即使給了 API 提現許可權,攻擊者也只能提到白名單地址,無法自由轉移。這是雙重鎖定的經典組合。

Q6:家裡沒有固定 IP,就完全不能跑量化了嗎?

A:不是。三種可選方案:(1)租一臺每月 5-10 美元的 VPS 用固定 IP;(2)用 Cloudflare Tunnel 中轉讓所有請求走固定出口;(3)用 DDNS + 幣安 API 定時更新 IP 白名單(幣安支援透過 API 修改 IP 白名單,但需要另一把管理 key)。Biabafox 推薦方案 1,最省心。

Q7:一個賬戶能建幾把 API key?

A:普通賬戶可以建 30 把,機構賬戶更多。Biabafox 建議:每個策略、每個團隊成員、每個用途各一把,方便審計和廢棄。用完立即刪,不要留著"以後可能用"。

Q8:洩漏後賬戶被惡意下單能追回嗎?

A:一般不能追回幣價損失。若是透過 IOC 單低於市價成交或砸盤等異常行為,幣安在 30 天內可以協助申訴,但最終能否返還取決於訂單是否符合"惡意操縱"定義。Biabafox 見過成功和失敗的案例各佔一半,最靠譜的還是提前防範。

風險提示

API key 一旦被惡意使用,損失通常在幾分鐘內完成,往往比手動操作賬戶的攻擊更快、更隱蔽。Biabafox 強烈建議:所有帶交易許可權的 key 必須繫結固定 IP、避免勾選提現許可權、每 30 天做一次巡檢、每 90 天輪換 secret。加密資產投資本身有市場波動風險,量化策略也可能因為程式 bug 造成損失,本文只解決"金鑰安全"這一環,不涉及策略盈虧。請透過 幣安官網 或 幣安官方App 的正規入口管理 API key。

內鏈導航:更多入口選擇請見 下載頁;若你還在糾結用 App 還是網頁端做 API 管理,可以先看 PC 與網頁端速選 再決定。

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