加密貨幣宏觀整理
2026 交易所 API 金鑰設定教學:OKX、Bybit、Bitget、幣安的權限與 IP 白名單
量化交易機器人用的 API 金鑰,只開讀取和交易,不開提現,綁定固定 IP,每個機器人用一個子帳戶。OKX、Bybit、幣安對沒綁 IP 的金鑰都有失效規則,天數各不相同。
Kelvin Wang · · 7 分鐘閱讀
這些規則來自四家交易所的官方 API 文件和說明頁,2026 年 11 月 7 日查核。這類規則會改,設定前請再看一次官方頁面。
API Key、Secret、Passphrase 各是什麼?
- API Key:金鑰的公開識別碼,每個請求都會帶上,讓交易所知道是哪一把金鑰。
- Secret Key:用來替請求簽章的私密字串。交易所只在建立時顯示一次,外流就等於別人可以用你的權限下單。
- Passphrase:OKX 和 Bitget 會要你在建立金鑰時自己設一組密碼,之後每個請求都要帶。OKX 只存加鹽雜湊,忘了就只能重建金鑰;Bitget 的 Passphrase 設定後不能修改,忘記也要刪掉重建。幣安和 Bybit 沒有 Passphrase。
幣安和 Bybit 另外支援自行產生的非對稱金鑰:你在自己電腦上產生一對 Ed25519 或 RSA 金鑰,只把公鑰交給交易所,私鑰從頭到尾不離開你的機器。系統產生的 HMAC 金鑰,交易所那邊也存著同一份 Secret。
我的機器人用的是 Ed25519 金鑰。
四家的規則比較
| 項目 | OKX | Bybit | Bitget | 幣安 |
|---|---|---|---|---|
| 建立位置 | 網頁「我的 API」頁(/account/my-api) | Bybit 網站產生;主網和測試網的金鑰分開建 | 網頁版個人中心 → API 管理;2023 年 8 月起 App 不能建立、修改或刪除金鑰 | 個人資料 → 帳戶 → API 管理;App 在「更多 → 其他 → API 管理」 |
| 權限 | Read、Trade、Withdraw;Trade 也包含資金劃轉 | 唯讀或讀寫,再勾合約、現貨、Wallet(劃轉)等類別;Withdraw 只有主帳戶有 | 唯讀、交易、劃轉、提現 | 讀取、交易、合約、提現等,依帳戶開通的產品而定 |
| IP 白名單 | 每把最多 20 個 IP,支援 IPv4、IPv6 和網段 | 可綁多個 IP,用逗號分隔 | 官方建議每把不超過 10 個 IP;提現只能從白名單 IP 發起 | 開提現必須綁 IPv4;系統產生的 HMAC 金鑰不綁 IP 只能有讀取權限 |
| 子帳戶 | 子帳戶金鑰只能 Read、Trade,子帳戶不能提現 | 主帳戶可建子帳戶和子帳戶金鑰,Withdraw 不在子帳戶權限內 | 主帳戶要先給子帳戶 API 管理權限,且可隨時檢視、修改、刪除子帳戶金鑰 | 子帳戶不能提現;一般用戶可開 5 個子帳戶,上限依 VIP 等級和帳戶類型提高 |
| 頻率限制(摘要) | 依端點計算;子帳戶每 2 秒最多 1,000 筆下單和改單 | 每個 IP 每 5 秒 600 個請求;下單端點約每秒 10 到 20 次 | 每個 IP 每分鐘 6,000 次;公開介面每秒 20 次 | 現貨每 IP 每分鐘 6,000 權重、每 10 秒 100 筆單;合約每分鐘 2,400 權重 |
查核日期 2026-11-07。來源見文末:OKX API 文件;Bybit API 文件(建立子帳戶金鑰、API Key 資訊、頻率限制);Bitget UTA 與經典版 API 文件、API 交易指南、App 停止管理金鑰公告;幣安建立 API 說明、資安部落格、子帳戶 FAQ,以及幣安現貨與合約 exchangeInfo 回傳的 rateLimits。
幾個表裡放不下的細節:
- OKX 的「閒置」只算需要金鑰驗證的呼叫;WebSocket 只有登入那一下算使用。模擬交易的金鑰不會失效。
- Bybit 的金鑰資訊介面會回傳
deadlineDay和expiredAt,只有沒綁 IP 或改過密碼的金鑰才有值,可以拿來寫到期提醒。Bybit 的 IP 限制超量會回 403,要關掉所有連線等至少 10 分鐘。 - 幣安的權重限制是算在 IP 上,不是算在金鑰上;被 429 之後還繼續打,會收到 418 並被封 IP,從 2 分鐘到 3 天不等。2023 年 1 月 30 日起,系統產生、不限 IP 的金鑰只能讀取。
- 幣安的下單數上限是算在帳戶上,同一個帳戶的所有金鑰共用。同一帳戶跑多個機器人,就會互相吃額度,這也是分子帳戶的理由之一。
安全設定的六條規則
永遠不開提現
機器人只需要查資料和下單。提現權限開著,金鑰外流時對方可以直接把幣領走。幣安的提現必須綁 IP 才能開,Bitget 的提現只能從白名單 IP 發起,OKX 和幣安的子帳戶根本不能提現,目的都是讓外流的金鑰領不走錢。
我每個機器人都只開讀取和合約交易,不開劃轉。
綁定 IP
機器人跑在固定 IP 的主機上,就把那個 IP 綁上去。綁了 IP,外流的金鑰從別的地方呼叫會被拒絕。OKX、Bybit、幣安的到期規則也都只針對沒綁 IP 的金鑰:OKX 是有交易或提現權限的金鑰閒置 14 天失效;Bybit 是 90 天後失效,改帳戶密碼後 7 天失效;幣安是閒置 30 天自動刪除。家裡網路的 IP 會變,機器人最好放在有固定 IP 的主機上。
我還沒遇過金鑰到期或 IP 變動讓機器人停掉。我的機器人跑在 AWS,白名單綁的是固定 IP。
每個機器人一個子帳戶
子帳戶把資金和權限隔開。一個機器人的金鑰出事,損失限在那個子帳戶的餘額;頻率限制也分開算,OKX 甚至有子帳戶層級的下單上限。主帳戶的金鑰不要拿去給任何機器人用。
我自己是依交易所分:每家交易所各開一個子帳戶給機器人用。
Secret 放在環境變數或密鑰管理服務
Secret 不要寫進程式碼、不要進 git、不要出現在截圖、聊天紀錄或客服對話裡。幣安的資安文章也建議加密保存或放進可信任的密鑰管理服務,並提醒有些第三方函式庫是專門設計來偷 API 金鑰的。
我的金鑰放在 AWS 的密鑰管理服務。
定期輪替
替換金鑰的流程要事先演練:先建新金鑰、更新機器人、確認新金鑰在下單,再刪舊的。Bitget 的 Passphrase 不能改,要換就只能整把重建。Bybit 沒綁 IP 的金鑰本來就會在 90 天後失效,等於被迫輪替;在 API 管理頁重新選一次「不限制 IP」,可以把期限延到 90 天後,Key 和 Secret 不變。
第三方工具收掉或出事時,馬上刪金鑰
不再用的工具、宣布停止服務的平台、傳出外洩消息的服務,相關金鑰當天就刪。刪金鑰不會影響帳戶裡的資產,要用時再建一把就好。
3Commas 事件:沒開提現,資產一樣被轉走
3Commas 是一家交易機器人平台,用戶把交易所 API 金鑰交給它代為下單。
2022 年 10 月,有人做了仿冒 3Commas 的網站收集用戶金鑰,再用這些金鑰在 FTX 的 DMG 交易對上下單。The Block 報導,鏈上資料顯示被盜總額約 600 萬美元,FTX 宣布一次性補償。當時 3Commas 認為問題不在自己的系統。
同年 12 月,一名匿名人士在 Twitter 公開約 10 萬把 API 金鑰,主要是幣安和 KuCoin 的用戶,並說這只是他手上的一成。幣安執行長趙長鵬警告,他相當確定 3Commas 有大規模金鑰外洩,要所有曾把金鑰交給 3Commas 的用戶立刻停用。12 月 28 日,3Commas 執行長 Yuriy Sorokin 確認檔案內容屬實,並請幣安、KuCoin 等交易所撤銷所有連到 3Commas 的金鑰。他說沒有找到內部人員涉案的證據。金鑰外洩的損失,交易所不一定會補:在 3Commas 確認外洩之前,一名把損失歸咎於 3Commas 金鑰外洩的用戶,就被幣安拒絕補償。在確認之前一週,已有用戶回報與這項服務有關的損失約 2,200 萬美元。
把金鑰交給第三方工具,你承擔的是什麼?
TradingView 的 Webhook 本身不需要你的交易所金鑰。警報觸發時,TradingView 只是把訊息用 HTTP POST 送到你指定的網址;真正拿金鑰下單的,是接收這個 Webhook 的伺服器。如果那台伺服器是你自己的,金鑰留在你手上;如果是第三方的轉單服務,金鑰就存在對方那裡。TradingView 也提醒不要把帳號密碼放進 Webhook 內容。它的 Webhook 要先開兩步驟驗證,只走 80 和 443 埠,並列出四個發送來源 IP,自架伺服器可以只放行這些 IP。
跟單機器人、雲端網格這類服務的運作方式相同:你的金鑰存在對方的資料庫裡。對方被入侵、員工出問題、公司倒閉,你都管不到。交出金鑰前可以問自己幾件事:
- 對方的伺服器有沒有公布固定 IP,讓你可以綁白名單?綁了之後,金鑰被偷也只能從對方的伺服器呼叫。
- 它要的權限是不是只有讀取和交易?要求提現或劃轉權限的工具,直接不用。
- 給它的金鑰是不是放在專用子帳戶,裡面只放願意承擔風險的金額?
- 工具停止服務或出事時,你知不知道去哪裡刪金鑰?
CoinGlass 這類數據網站也有 API Key,那是向 CoinGlass 帳戶申請、放在 CG-API-KEY 標頭裡查數據用的,跟交易所金鑰是兩回事,碰不到你的資產。
交易所本身出事時怎麼應對,可以看交易所被駭怎麼辦和交易所事件整理。各家手續費比較在交易所手續費,四家的評測在 OKX、Bybit、Bitget、幣安。
想開 OKX 帳戶,手續費減免的細節在 OKX 頁面。
資料來源
- 1. OKX API v5 文件(REST 驗證、API Key 安全、子帳戶、頻率限制、錯誤碼)
- 2. Bybit API:Create Sub UID API Key
- 3. Bybit API:Get API Key Information
- 4. Bybit API:Rate Limit Rules
- 5. Bybit API:Integration Guidance
- 6. Bitget API:UTA Quick Start
- 7. Bitget API:Classic REST API
- 8. Bitget API Trading Guideline
- 9. Bitget Announcement on the suspension of API key management support on the app
- 10. Bybit API:FAQ
- 11. How to Create API Keys on Binance
- 12. How to Use an API Key Securely: 5 Tips From Binance
- 13. Binance's API Key Deletion Policy
- 14. Binance Sub-Account Functions and FAQ
- 15. Binance Spot API:Rate limits
- 16. Binance WebSocket API:Rate limits
- 17. Binance 現貨 exchangeInfo(rateLimits)
- 18. Binance 合約 exchangeInfo(rateLimits)
- 19. FTX will compensate phishing victims up to $6 million, says Sam Bankman-Fried
- 20. Crypto trading service 3Commas confirms massive API key leak
- 21. 3Commas CEO confirms API key leak following warning from CZ
- 22. About webhooks
- 23. CoinGlass API:Authentication