BingX 的 API Key 在網頁或 App 的「API 管理」頁建立，建立後會拿到 API Key 和 Secret Key 兩組資訊；官方建議設定 IP 白名單，Key 外洩就立刻刪除重建。權限分現貨交易、讀取、永續合約交易、萬向劃轉和子帳號內部轉帳，現貨和 U 本位合約共用同一把 Key、權限分開設定。每個主帳號最多 20 組 Key，請求的時間戳要在伺服器時間 5 秒以內，行情介面的 IP 限速是每 10 秒 500 次（BingX 官方 API 文件，查詢日 2026-10-17）。
這篇依 BingX 官方 API 文件與 API 常見問題整理：建立與權限、IP 白名單、簽名與時間戳、限速與風控、模擬盤測試，以及 API 下單的手續費與返佣。用我們的邀請碼 FEEOTTER 註冊 BingX，手續費返 45%（全部是 BingX 自動返佣），不需要綁定 UID，也不需要把 API Key 交給 Fee Otter。
快速結論
- 在哪建立：BingX 網頁或 App 的「API 管理」頁；官方常見問題寫明 App 也支援管理 API Key。
- 權限：現貨交易、讀取、永續合約交易、萬向劃轉、子帳號內部轉帳；官方 API 文件也列了子帳號 Key 的「提幣」權限。
- 數量：每個主帳號最多 20 組 Key、20 個子帳號，每個子帳號也能建 20 組。
- 簽名：HMAC SHA256，Header 帶 X-BX-APIKEY，時間戳和伺服器差距不能超過 5 秒。
- 限速：依 UID 逐個介面限速，行情介面另有每 10 秒 500 次的 IP 限速；觸發後約 5 分鐘恢復。
- 模擬盤：合約模擬盤網域 open-api-vst.bingx.com，用虛擬 USDT（VST）。
建立步驟
官方 API 文件〈Generate an API Key〉寫的流程很簡短：先到 BingX 的 API 管理頁建立 Key，建立後會得到 API Key 和 Secret Key，兩者都要記下來、不要告訴任何人；設定時建議同時設 IP 白名單；Key 意外外洩就立刻刪除，重新產生一組。
- 登入 BingX，進入帳戶的「API 管理」頁，按建立 API。
- 填備註名稱，勾選需要的權限，能綁 IP 就填 IP 白名單。
- 完成安全驗證後，複製 API Key 和 Secret Key 存在安全的地方。
建立前要先完成哪些設定（KYC、雙重驗證），以及 Secret Key 是否只顯示一次，這次在 BingX 官方說明中心沒有找到逐步教學，以建立頁面的提示為準。來源：BingX API 文件、BingX API 常見問題（2026-10-14 更新）。
權限：每一組該不該開
| 權限 | 做什麼 | 建議 |
|---|---|---|
| 讀取 | 查詢餘額、倉位、訂單 | 記帳、報稅工具只開這個 |
| 現貨交易 | 現貨下單、撤單 | 只跑現貨策略才開 |
| 永續合約交易 | U 本位永續下單、撤單、調槓桿 | 合約策略需要 |
| 萬向劃轉 | 在現貨、合約等帳戶之間搬資金 | 策略需要自動調度資金才開 |
| 子帳號內部轉帳 | 允許子帳號之間內部轉帳 | 只在主帳號管理子帳號時用 |
權限代碼見官方 API 文件的「建立子帳號 API Key」介面：1 現貨交易、2 讀取、3 永續合約交易、4 萬向劃轉、7 允許子帳號內部轉帳；文件更新紀錄另寫明子帳號 Key 新增了 5「提幣」。官方常見問題也說明，U 本位合約和現貨用的是同一把 API Key，但兩邊的交易權限要分開設定。給第三方機器人或跟單工具的 Key，只開交易權限，不要開提幣，也不要開萬向劃轉。
IP 白名單
官方文件建議建立 Key 時設定 IP 白名單；從不在白名單上的 IP 送出請求，會收到錯誤碼 100419「IP does not match IP whitelist」。一把 Key 最多能綁幾個 IP、能不能填 IP 段，以及沒綁 IP 的 Key 會不會過期，這次在官方文件與說明中心沒有找到，以建立頁面顯示為準。BingX 伺服器架在 AWS 新加坡區（ap-southeast-1），延遲敏感的策略可以把主機放在附近。
簽名、時間戳與網域
- 簽名：用 Secret Key 對請求參數做 HMAC SHA256，結果放在 signature 參數。參數放在 query string 時直接照原順序拼接、不需排序；放在 request body 時要依 a～z 排序後拼接。
- Header：請求要帶 X-BX-APIKEY: 你的 API Key。
- 時間戳：毫秒，必須在 API 伺服器時間的 5 秒以內，否則視為過期拒絕；本機時間偏差大時，先查 /openApi/swap/v2/server/time 校正。
- 網域：實盤 open-api.bingx.com，合約模擬盤 open-api-vst.bingx.com。
下面是查詢 USDT 永續合約帳戶餘額的最小範例（Python，僅供示意）：
import time, hmac, hashlib, requests
API_KEY = "你的 API Key"
SECRET = "你的 Secret Key"
HOST = "https://open-api.bingx.com" # 模擬盤改用 https://open-api-vst.bingx.com
path = "/openApi/swap/v3/user/balance"
params = f"timestamp={int(time.time() * 1000)}"
sign = hmac.new(SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()
r = requests.get(f"{HOST}{path}?{params}&signature={sign}",
headers={"X-BX-APIKEY": API_KEY})
print(r.json())Key 和 Secret 不要寫死在程式碼裡，正式使用時改用環境變數。
限速與風控
依官方 API 文件的「Rate limit」與 API 常見問題：
- 依 UID 限速：每個介面各自獨立計算，互不影響，各介面的額度寫在該介面文件裡；回應 Header 的 X-RateLimit-Requests-Remain（剩餘次數）和 X-RateLimit-Requests-Expire（窗口到期時間）可以用來動態調整頻率。
- IP 限速：行情介面每 10 秒 500 次。2025-12-16 起，帳戶類介面第 2、3 組原本的 IP 限速（每組每 10 秒 2,000 次、單一介面 300 次）已經取消。
- 觸發後：請求太頻繁會被自動限制，約 5 分鐘後恢復；收到 429 還繼續送，IP 可能被自動封鎖（418）；收到 403 代表觸發防火牆，多數情況暫停 5 分鐘，被判定惡意可能更久甚至永久。
- 同一筆單：同一張訂單每秒只能送出一次；撤單介面對同一個 orderId 每秒限一次。
BingX 官方 API 常見問題：交易行為若與一般用戶差異很大，可能被禁止交易，期限不定；經常霸占最優買賣價、頻繁下單撤單卻沒有成交、成交率或成交權重很低，以及收到 429 後仍持續頻繁請求，都會延長禁止交易的時間。（BingX API FAQ-08）
官方文件沒有在這份說明裡列出合約下單介面的 UID 次數上限，以回應 Header 的剩餘次數為準。
先在模擬盤跑
官方 API 文件寫明，合約模擬盤的下單網域是 open-api-vst.bingx.com，保證金和盈虧都以 VST（虛擬 USDT）計；VST 不夠時可以呼叫 /openApi/swap/v2/trade/getVst 申請（2025-12-18 起升級為 v2，可增加或減少自訂金額）。另有 /openApi/swap/v2/trade/order/test 測試下單介面：參數和回傳與正式下單相同，但不會真的下單、也不扣資金，適合先驗證簽名和參數。網頁與 App 的模擬交易規則見〈永續合約模擬交易上線〉。
其他官方限制：API 目前不支援標準合約；股票、外匯、商品、指數等 TradFi 永續交易對可以用 API 交易。下單的價格和數量精度、最小下單量可以從 /openApi/swap/v2/quote/contracts 取得，超出精度的部分會被截斷。
API 下單的手續費與返佣
API 下單的手續費和手動下單一樣，照你的 VIP 等級收：一般用戶永續合約 maker 0.02%、taker 0.05%。BingX 的 VIP 4 以上，成交量路線要求 API 成交占比不超過 20%，量化帳戶要升高等級，通常得走資產路線。
返佣方面，BingX 官方公開頁面這次沒有找到「API 成交不給推薦返佣」的規定，實際以你 BingX 帳戶的返佣紀錄為準；這點和 MEXC 不同，MEXC 的聯盟常見問題寫明 API 成交不計佣金。以每月 API 合約成交 500 萬 USDT、六成掛單四成吃單估算，混合費率 0.6 × 0.02%＋0.4 × 0.05%＝0.032%，月手續費約 1,600 USDT，45% 返佣約退回 720 USDT。各家 API 規則比較見 交易所 API 比較，量化交易者的返佣算法見 量化交易的手續費返佣。
用我們的邀請碼 FEEOTTER 註冊 BingX，45% 由 BingX 直接退回你的 BingX 帳戶，不需要到 Fee Otter 綁定 UID，Fee Otter 也從來不需要你的 API Key、密碼或提幣權限。比例依 Fee Otter 與 BingX 的合作條件設定、可能調整。
Telegram · @feeotter