外觀

語言

加密貨幣宏觀整理

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 金鑰。

四家的規則比較

項目OKXBybitBitget幣安
建立位置網頁「我的 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. 1. OKX API v5 文件(REST 驗證、API Key 安全、子帳戶、頻率限制、錯誤碼) · okx.com · 查核 2026-11-07
  2. 2. Bybit API:Create Sub UID API Key · bybit-exchange.github.io · 查核 2026-11-07
  3. 3. Bybit API:Get API Key Information · bybit-exchange.github.io · 查核 2026-11-07
  4. 4. Bybit API:Rate Limit Rules · bybit-exchange.github.io · 查核 2026-11-07
  5. 5. Bybit API:Integration Guidance · bybit-exchange.github.io · 查核 2026-11-07
  6. 6. Bitget API:UTA Quick Start · bitget.com · 查核 2026-11-07
  7. 7. Bitget API:Classic REST API · bitget.com · 查核 2026-11-07
  8. 8. Bitget API Trading Guideline · Bitget · 2023-01-03
  9. 9. Bitget Announcement on the suspension of API key management support on the app · Bitget · 2023-08-01
  10. 10. Bybit API:FAQ · bybit-exchange.github.io · 查核 2026-11-07
  11. 11. How to Create API Keys on Binance · binance.com · 查核 2026-11-07
  12. 12. How to Use an API Key Securely: 5 Tips From Binance · Binance · 2025-03-24
  13. 13. Binance's API Key Deletion Policy · Binance Blog(Binance Square) · 查核 2026-11-07
  14. 14. Binance Sub-Account Functions and FAQ · binance.com · 查核 2026-11-07
  15. 15. Binance Spot API:Rate limits · developers.binance.com · 查核 2026-11-07
  16. 16. Binance WebSocket API:Rate limits · developers.binance.com · 查核 2026-11-07
  17. 17. Binance 現貨 exchangeInfo(rateLimits) · api.binance.com · 查核 2026-11-07
  18. 18. Binance 合約 exchangeInfo(rateLimits) · fapi.binance.com · 查核 2026-11-07
  19. 19. FTX will compensate phishing victims up to $6 million, says Sam Bankman-Fried · The Block · 2022-10-24
  20. 20. Crypto trading service 3Commas confirms massive API key leak · SiliconANGLE · 2022-12-29
  21. 21. 3Commas CEO confirms API key leak following warning from CZ · Cointelegraph · 2022-12-28
  22. 22. About webhooks · TradingView · 查核 2026-11-07
  23. 23. CoinGlass API:Authentication · docs.coinglass.com · 查核 2026-11-07

關於作者

Kelvin Wang

電機工程師,和 AI Agent 做工具,分享工程與投資的實作筆記。

更多關於我