幣安 API Key 怎麼申請？權限設定、IP 白名單與安全清單

幣安 API Key 在網頁端「頭像 → 帳戶 → API 管理 → 建立 API」申請，建立前需要開啟雙重驗證（2FA）並完成身份認證。權限上，日常查行情、查餘額、程式下單只需要讀取和現貨交易兩項，提現權限永遠不要開，同時給 Key 繫結 IP 白名單。新建 Key 時優先選「自行生成」的 Ed25519 類型，幣安官方文件已經把系統生成的 HMAC Key 標為不推薦使用。

申請幣安 API Key 之前要準備什麼？

截至 2026 年 10 月，幣安幫助中心列出的前置條件有三項：

1. 開啟 2FA：身份驗證器、通行金鑰（Passkey）或其他雙重驗證方式，建立 Key 時需要驗證。
2. 啟用帳戶：向現貨錢包充值任意金額。
3. 完成身份認證（KYC）：還沒註冊或沒認證的，可以先看 幣安註冊與 KYC 教程，認證卡住時參考 KYC 失敗怎麼辦。

另外要注意地區限制：幣安不向部分國家和地區提供服務（包括中國大陸、美國，新加坡使用者也不能使用 Binance.com），香港、臺灣、馬來西亞等地也有當地的牌照或限制問題。API 和網頁、App 適用同一套使用者協議，請先確認你所在地區可以合法使用。

系統生成和自行生成的 API Key 有什麼區別？

點「建立 API」後，幣安會讓你先選金鑰類型。兩類的根本區別在於簽名用的金鑰由誰生成、儲存在哪裡：

幾個細節：

• 幣安幫助中心寫明，自 2023 年 1 月 30 日起，未限制 IP 的系統生成 Key 只能設為「讀取」，想開交易就必須繫結 IP。
• 無論是系統生成還是自行生成的 Key，開啟提現權限都必須先設定 IP 限制。
• RSA 支援 2048 位和 4096 位，簽名比 Ed25519 大得多，請求體也更大。
• Ed25519 的安全強度與 3072 位 RSA 相當，簽名更短、計算更快，這也是幣安推薦它的原因。
• HMAC 的 Secret Key 只在建立時顯示一次，關掉頁面就再也看不到了。

簽名到底是怎麼計算的，可以看 交易所 API 簽名原理，裡面用官方示例逐步復現了 HMAC 簽名。

怎麼在本地生成 Ed25519 金鑰對？

幣安官方在 GitHub 提供了圖形化的金鑰生成工具（binance/asymmetric-key-generator），也可以直接用 OpenSSL 3.x 命令列生成：

# 生成私鑰（這個檔案絕不能給任何人，也不要上傳到網盤或程式碼倉庫）
openssl genpkey -algorithm ed25519 -out binance-prv-key.pem

# 由私鑰匯出公鑰（只把這個提交給幣安）
openssl pkey -in binance-prv-key.pem -pubout -out binance-pub-key.pem

cat binance-pub-key.pem

執行後公鑰類似這樣（每個人生成的都不同）：

-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEA+yj4UcRImkotfk1xV1Js0ugTeW+c9aDYjxUchcwi9as=
-----END PUBLIC KEY-----

建立 Key 時選「自行生成」，把整段公鑰（含首尾兩行）貼上進去即可。之後幣安會給你一個 API Key 字串，簽名則用你本地的私鑰完成。

網頁端建立幣安 API Key 的步驟

1. 登入幣安網頁版，點右上角頭像 → 帳戶 → API 管理。
2. 點建立 API，選擇金鑰類型：系統生成，或自行生成（貼上 Ed25519/RSA 公鑰）。
3. 填寫標籤名，建議寫清用途，例如「行情指令碼-只讀」「測試策略-現貨」，以後一眼能分清。
4. 完成 2FA 或通行金鑰驗證，Key 建立成功。
5. 系統生成類型會顯示 API Key 和 Secret Key，立刻複製儲存到密碼管理器，Secret Key 只顯示這一次。
6. 在這個 Key 的卡片上點編輯限制，設定 IP 白名單和權限，儲存時再次驗證。

手機端路徑是：切換到專業版 → 首頁「更多」→ 往下找到「其他」裡的 API 管理 → 建立 API。手機上覆制長字串容易出錯，建議在電腦上操作。

幣安 API 權限應該勾選哪些？

新建的 Key 預設只有讀取權限，其他權限要你手動勾選。下表按普通使用者寫程式的場景給出建議：

只查行情根本不需要 API Key，行情屬於公開介面，不簽名也能呼叫。只想看餘額、做記帳表格，用「只讀」Key 就夠了。確實要程式下單，再單獨建一個開了現貨交易的 Key，兩個 Key 分開管理。

幣安 API 的 IP 白名單怎麼設定？

在 Key 的「編輯限制」裡選限制只對受信任 IP 的訪問，填入執行程式那臺機器的公網 IPv4 地址，需要多個地址時按頁面提示的格式逐個新增。幣安幫助中心的規則是：任何類型的 Key 開啟提現權限都必須先新增 IP 限制；系統生成的 Key 不繫結 IP 就只能讀取。

實際操作中要注意：

• 填公網 IP，不是區域網 IP。192.168.x.x、10.x.x.x 這類地址是家裡路由器分配的，幣安看不到。雲伺服器的公網 IP 可以在雲服務商控制台查到。
• 家庭寬頻的公網 IP 通常會變。IP 一變，請求就會被拒絕，報錯 -2015。長期執行的程式放在有固定 IP 的雲伺服器上更穩定。
• 白名單要填 IPv4 格式。幣安幫助中心寫明 IP 限制使用 IPv4 格式；更換伺服器後，記得同步更新白名單。

為什麼建議用幣安子帳戶跑 API？

子帳戶可以把程式能動用的資金和主帳戶隔開：就算程式出 bug 或 Key 洩露，損失也只限於子帳戶裡的那部分錢。截至 2026 年 10 月，幣安幫助中心的規則如下：

• 完成身份認證並開啟 2FA 的使用者都能建立子帳戶，普通使用者最多 5 個，VIP 使用者按等級更多。
• 每個子帳戶最多可建立 30 個 API Key。
• 子帳戶不能直接提現，資金劃轉只能由母帳戶操作。

建立路徑：母帳戶登入 → 頭像 → 儀表盤 → 子帳戶 → 帳戶管理 → 建立子帳戶；再到子帳戶頁面的 API 管理 標籤為它建立 Key。用法很簡單：只往子帳戶裡轉你願意讓程式動用的金額，主帳戶的 Key 一個都不開交易權限。

先用幣安測試網驗證 Key 和程式碼

正式用實盤 Key 前，強烈建議先在幣安現貨測試網跑通程式碼：

• 地址是 testnet.binance.vision，用 GitHub 帳號登入後生成測試用 Key，支援 HMAC、RSA、Ed25519。
• 註冊後自動獲得多種虛擬資產，不能充提，也沒有任何價值。
• 只開放 /api 介面，不支援 /sapi（錢包、理財等）介面。
• 測試網大約每月重置一次，訂單和餘額會清空，官方不提前通知。

幣安另有網頁版的模擬交易（demo.binance.com），用幣安帳號登入，也能在其中的 API 管理建立模擬交易 Key。注意：測試網、模擬交易和實盤的 Key 互不通用，拿實盤 Key 連測試網會直接報錯。

下面這段 Python 用 CCXT 驗證 Key 是否可用（安裝方法見 CCXT 入門教程），Key 從環境變數讀取：

import os
import ccxt

secret = os.environ.get("BINANCE_API_SECRET")
pem_path = os.environ.get("BINANCE_PRIVATE_KEY_PATH")  # 自行生成的 Ed25519 Key：填私鑰檔案路徑
if pem_path:
    with open(pem_path) as f:
        secret = f.read()  # CCXT 識別到 PEM 私鑰後會自動改用 Ed25519/RSA 簽名

ex = ccxt.binance({
    "apiKey": os.environ["BINANCE_API_KEY"],
    "secret": secret,
    "options": {"fetchMarkets": {"types": ["spot"]}},
})
ex.set_sandbox_mode(True)  # 測試網 Key 用這一行；實盤 Key 刪掉這一行

try:
    balance = ex.fetch_balance()
    print("Key 可用，非零資產：", {k: v for k, v in balance["total"].items() if v})
except ccxt.AuthenticationError as e:
    print("認證失敗：", e)

用一個格式正確但並未在幣安登記的 Key 執行，測試網返回的真實結果是：

認證失敗： binance {"code":-2015,"msg":"Invalid API-key, IP, or permissions for action."}

常見報錯對照：

幣安 API Key 洩露了怎麼辦？

如果你把 Key 發給過別人、上傳到了公開程式碼倉庫、在截圖裡露出過，或者發現不是自己下的訂單，按這個順序處理：

1. 立即刪除 Key：API 管理 → 找到對應 Key → 刪除。只改權限不夠，刪除才能讓它徹底失效。不確定是哪個 Key 洩露，就把所有 Key 都刪掉，再按需重建。
2. 檢查帳戶：檢視當前委託、歷史成交、提現記錄和地址簿，確認有沒有陌生訂單或陌生提現地址。
3. 修改登入密碼、重置 2FA：如果懷疑電腦中了木馬，先在乾淨的裝置上操作。
4. 聯絡幣安客服：通過官網或 App 內的線上客服提交情況，說明 Key 洩露的時間和你已經刪除了哪些 Key。
5. 排查洩露源頭：程式碼倉庫裡的 Key 要連同提交歷史一起清理，否則舊版本里仍然能翻到。

更完整的帳戶防護設定，見 帳戶安全設定指南。

幣安 API Key 安全清單

建立完 Key 後，對照檢查一遍：

• 優先使用自行生成的 Ed25519 Key，私鑰只儲存在執行程式的機器上。
• 只開「讀取」，需要下單時再加「現貨及槓桿交易」，不開合約、劃轉、提現。
• 繫結執行程式那臺機器的公網 IPv4。
• 程式放在子帳戶裡跑，子帳戶只放願意讓程式動用的錢。
• 程式碼裡不寫死 Key，用環境變數或本機配置檔案讀取，並把配置檔案排除出程式碼倉庫。
• 不同用途用不同 Key，並在標籤裡寫清用途，不用的 Key 及時刪除。
• 先在測試網跑通，再換實盤 Key。

本文僅供學習參考，不構成投資建議。交易所的費率、活動與功能可能隨時調整，請以官方頁面為準。文中部分連結為推廣連結，詳見推廣披露。