幣安 API key 最小許可權與 IP 白名單|量化使用者必讀三段配置
Biabaflow 用一個真實量化賬戶完整走一遍 API Key 的最小許可權配置,覆蓋讀寫許可權拆分、IP 白名單、Key 輪換週期與洩漏應急,落到量化使用者能直接抄的實操手冊。
先說結論:幣安 API Key 的預設許可權是「只讀 + 交易」,提現許可權預設關閉。做量化只需要「只讀 + 交易」,絕大多數場景下不需要開啟提現許可權;再疊加 IP 白名單,即使 Key 洩漏也不會導致資產被提走。這套配置只需要 10 分鐘,是量化使用者必做的功課。Biabaflow 實操流程站用一個真實量化賬戶走完全流程,整理成本手冊。
一、API Key 許可權層級
1.1 三種許可權
- Enable Reading:只讀,可以看餘額、歷史訂單;
- Enable Spot & Margin Trading:現貨與槓桿交易;
- Enable Withdrawals:提現(預設關閉)。
1.2 附加許可權
- Enable Futures:合約交易;
- Universal Transfer:賬戶內互轉;
- Options:期權交易。
1.3 最小許可權原則
Q:為什麼要遵循最小許可權?
A:一旦 Key 洩漏,攻擊者能做的操作範圍僅限於你授予的許可權。開得越少,洩漏後損失越小。做量化只需要能下單和讀賬戶,其它許可權一律關閉。
二、建立 API Key 的完整流程
2.1 步驟
按順序:
- 網頁版登入 www.binance.com/zh-CN;
- 頭像 → API 管理;
- 輸入 Key 名稱(例如 quant-2026-07);
- 郵箱 + 2FA 驗證;
- 系統生成 API Key 與 Secret Key;
- 立即抄寫 Secret Key(只顯示一次);
- 設定許可權與 IP 白名單。
2.2 Secret Key 儲存
Secret Key 只在生成時顯示一次,之後無法再查。請立即抄到密碼管理器或加密檔案裡。
Q:忘了 Secret Key 怎麼辦?
A:無法找回。只能刪除舊 Key、重新建立新的。
2.3 許可權勾選
只勾選實際需要的許可權。做純讀程式(例如價格監控)只勾 Reading,其它一律不開。
三、IP 白名單
3.1 為什麼必須開
若不開 IP 白名單,任何知道 Key 的第三方都能用它下單。開啟後即使 Key 洩漏,攻擊者從不同 IP 無法呼叫。
3.2 常見 IP 配置
- 家用寬頻:家裡的靜態 IP 或 IPv6 字首;
- VPS 部署:VPS 的固定 IP;
- 雲函式:函式執行環境的 IP 段。
3.3 多 IP 白名單
Q:可以填多個 IP 嗎?
A:可以。用逗號分隔。建議只填必要的 IP,不建議為了方便留大範圍。
| 配置 | 安全性 | 適合場景 |
|---|---|---|
| 單個 IP | 極高 | VPS 量化 |
| 家 + 公司 | 高 | 手動交易 |
| 一個 /24 段 | 中 | 雲函式 |
| 無 IP 限制 | 極低 | 不建議 |
四、Key 輪換週期
4.1 建議週期
- 高頻交易 Key:30-60 天輪換;
- 中低頻 Key:90 天輪換;
- 只讀監控 Key:180 天輪換。
4.2 輪換流程
按順序:
- 建立新 Key;
- 部署到量化系統;
- 驗證新 Key 工作正常;
- 刪除舊 Key;
- 更新密碼管理器條目。
4.3 應急刪除
若懷疑 Key 洩漏,立即刪除。刪除後 5 秒內 Key 不再可用,攻擊者無法繼續操作。
五、Key 洩漏的應急流程
按順序:
- 登入網頁版 → API 管理;
- 找到懷疑洩漏的 Key;
- 點「Delete」立即刪除;
- 檢查最近 24 小時的訂單與提現記錄;
- 若發現異常訂單,聯絡官方工單;
- 修改賬戶密碼 + 重置 2FA;
- 24 小時後建立新 Key,配置更嚴格的 IP 白名單。
5.1 場景排查
Q:Key 是不是從我的 GitHub 洩漏的?
A:完全可能。GitHub 上的 API Key 洩漏是最常見的量化使用者事故。使用 git-secrets 或 pre-commit hook 攔截提交,是必裝工具。
5.2 不要在公共電腦上生成 Key
Q:可以在網咖生成 Key 嗎?
A:不能。公共電腦存在鍵盤記錄、剪貼簿監聽風險。只能在私人可信裝置上生成。
想在完成 API 配置後立即自查賬戶,可以走 幣安官網 登入看裝置記錄;App 走 幣安官方 App 下載頁;新賬戶走 立即註冊幣安。日常複核入口回到 App 下載頁 與 官網入口專題。
5.3 風險提示
風險提示:任何聲稱能幫你「最佳化 API 效能」「代理下單加速」的第三方服務本質上是讓你交出 API Key。一旦交出,資產控制權就在對方手裡,Biabaflow 強烈不建議。
六、常用配置速查
| 場景 | 許可權 | IP 白名單 |
|---|---|---|
| 價格監控 | 只讀 | 伺服器 IP |
| 網格量化 | 只讀+現貨 | VPS IP |
| 合約策略 | 只讀+合約 | VPS IP |
| 手動輔助 | 只讀+現貨 | 家寬 IP |
| 提現自動化 | 不建議開 | 嚴格 |
七、Biabaflow 複測承諾
- 每季度重新走一遍 API 許可權;
- 收集讀者的量化坑,追加到常見問題;
- 若幣安引入新的許可權維度會立刻更新。
八、常見問題
問:Enable Withdrawals 什麼時候需要開?
A:極少數需要程式化提現的場景。若開啟,務必配合 IP 白名單 + 提現地址白名單,缺一不可。
問:API Key 會自動過期嗎?
A:預設 90 天自動過期。到期後需要手動重新建立或延長。
問:Sub-account 的 Key 會共享主賬戶許可權嗎?
A:不會。子賬戶 Key 只對子賬戶資產生效。
問:API 呼叫頻率有限制嗎?
A:有。每個 Key 有權重限制,超過會被臨時封禁。參考官方 API 文件合理控制頻率。
問:Biabaflow 會開源量化模板嗎?
A:Biabaflow 實操流程站主要以文件為主,不提供實盤量化模板。可以參考官方 API 文件與開源社群。
文件釋出於 2026-07-11,下次複測計劃 2026-10-01。