WEEX 的 API Key 在網頁版建立，每個帳號最多 10 組；新 Key 預設只有唯讀，要下單得另外勾「合約」或「現貨」交易權限，官方文件只列了唯讀和交易兩類，沒有提幣權限。建立時可以綁 IP，Passphrase 只能用英數字、遺失後無法找回；新建或修改的 Key 約 15 分鐘後才全面生效。合約下單限速是每個帳號每分鐘 300 次，模擬盤網域 api-sim.weex.com 可以先拿來測試（WEEX 官方 API 文件，查詢日 2026-10-17）。
本文依 WEEX V3 API 文件與官方公開 API 整理：Key 怎麼建、權限怎麼選、簽名與時間戳、各類端點的限速、哪些合約開放 API 交易、模擬盤怎麼用，最後是 API 下單的手續費與返佣在官方條款裡怎麼寫。用邀請碼 otter123 註冊 WEEX，合約返佣 70%（60% 交易所自動返佣＋10% 額外返佣），是市面常見 20% 邀請碼的 3.5 倍，策略每一筆成交付出的手續費，都有一部分會退回。
快速結論
- 網頁版建立：API 管理頁建立，每個用戶最多 10 組 Key；要保存 APIKey、SecretKey 與自訂的 Passphrase 三樣東西。
- 權限：預設唯讀；跑合約策略勾「合約」，跑現貨勾「現貨」。兩種權限互相獨立，沒勾就會回
-1052權限不足。 - IP 綁定：建立時可以綁 IP，官方寫明不綁 IP 的 Key 有安全風險，強烈建議開白名單。
- 限速：下單按帳號計，合約每分鐘 300 次、現貨每 10 秒 100 次；其他端點按 IP 權重計。超限回 HTTP 429，繼續送會被封 10 秒。
- 不是每個合約都能用 API：官方 API 清單上 1,040 個合約裡有 298 個開放 API 交易，BTCUSDT、ETHUSDT、SOLUSDT 都在內。
- 返佣：綁定返佣只需要 UID，不用交出任何 API Key。
建立步驟
依 WEEX 合約 API 文件〈Preparation〉（查詢日 2026-10-17）：
- 登入 WEEX 網頁版，進入 API 管理頁（
weex.com/account/newapi），建立新的 API Key。 - 設定一組 Passphrase。官方 FAQ 提醒只用英文字母和數字，不要加特殊符號。
- 選權限：新 Key 預設是唯讀，需要下單才勾「合約」或「現貨」。
- 需要的話綁定 IP 位址。
- 建立後保存 APIKey、SecretKey 與 Passphrase。Passphrase 一旦遺失無法找回，也不能修改，只能刪掉重建。
官方 FAQ 寫明，新建或修改過的 API Key，大約要 15 分鐘才會在整個系統生效，剛建好就回驗證錯誤時，先等一下再測。另外，WEEX 舊版的錯誤碼說明有一條 40016：帳號必須先綁定手機或 Google 驗證器（WEEX API 常見錯誤代碼）。這篇是 2025 年的舊版 API 說明，V3 是否沿用，文件沒有寫，建議先把 2FA 綁好。
帳號觸發風控（例如可疑登入、大量無效請求）時，API 權限可能被自動停用，要找客服重新開通。官方建議改用 V3 介面，V1、V2 正在淘汰。
權限：該開哪一種
依官方合約 API FAQ與現貨 API FAQ（2026-04-14 更新）：
| 權限 | 能做什麼 | 適合 |
|---|---|---|
| 唯讀（Readonly，預設） | 只能呼叫查詢類端點：餘額、持倉、成交紀錄 | 資產監控、記帳、行情分析 |
| 合約（Futures） | 開平倉、設定止盈止損、查詢合約持倉 | 合約策略、對沖 |
| 現貨（Spot） | 現貨下單、撤單、查詢現貨資產 | 現貨策略、自動再平衡 |
一般用戶的 Key 在官方文件裡就只有這幾種權限，沒有列出提幣權限。經紀商子帳戶的 API 另有充提權限，那是經紀商串接用的另一套規則，與自己跑策略無關。
跟單交易的 API 也是分開的：只有交易員身分能建立，每個交易員帳號限 1 組 Key，跟單帳戶的資金與持倉和一般合約完全隔離，而且不支援現貨（跟單 API FAQ）。帶單流程見 WEEX 跟單交易。
簽名、時間戳與網域
依官方〈Signature〉與〈General Information〉：
- 網域：合約正式環境
https://api-contract.weex.com，合約模擬盤https://api-sim.weex.com；現貨https://api-spot.weex.com。 - 標頭：私有端點帶
ACCESS-KEY、ACCESS-SIGN、ACCESS-TIMESTAMP、ACCESS-PASSPHRASE四個標頭，Content-Type設application/json。 - 簽名：把「時間戳＋大寫請求方法＋請求路徑＋（有查詢字串時）? 與查詢字串＋請求內容」串起來，用 SecretKey 做 HMAC SHA256，再做 Base64。
- 時間戳：毫秒，與伺服器時間相差超過 30 秒會被拒。主機時間要保持同步，或先查伺服器時間再用。
下面用合約模擬盤查詢帳戶餘額（GET /capi/v3/account/balance，IP 權重 5），Key 從環境變數讀，不要寫死在程式裡：
import base64, hashlib, hmac, os, time, requests
KEY = os.environ["WEEX_API_KEY"] # read-only is enough for this call
SECRET = os.environ["WEEX_API_SECRET"]
PASSPHRASE = os.environ["WEEX_API_PASSPHRASE"]
HOST = "https://api-sim.weex.com" # simulation; live: https://api-contract.weex.com
path, query, body = "/capi/v3/account/balance", "", ""
ts = str(int(time.time() * 1000))
message = ts + "GET" + path + ("?" + query if query else "") + body
sign = base64.b64encode(
hmac.new(SECRET.encode(), message.encode(), hashlib.sha256).digest()
).decode()
r = requests.get(HOST + path, headers={
"ACCESS-KEY": KEY, "ACCESS-SIGN": sign, "ACCESS-TIMESTAMP": ts,
"ACCESS-PASSPHRASE": PASSPHRASE, "Content-Type": "application/json",
})
print(r.status_code, r.headers.get("X-USED-WEIGHT-1M"), r.text[:200])官方寫明合約模擬盤支援所有合約 REST 端點，路徑、參數和簽名規則都和正式環境相同，換掉網域即可。模擬盤要不要另外建 Key，文件沒有寫，以實際測試為準。現貨文件沒有列模擬盤網域。
限速：各類端點的額度
依官方〈Access Restrictions〉：下單以外的端點按 IP 計權重，與 Key、UID 無關；下單端點按帳號（userId）計次數，不消耗 IP 權重。下表數字取自兩份 API FAQ 與官方公開的 exchangeInfo 端點，查詢日 2026-10-17：
| 類別 | 項目 | 額度 |
|---|---|---|
| 合約 | 下單（按帳號） | 300 次／分鐘 |
| 其他 REST 端點（按 IP 權重） | FAQ：500 權重／10 秒；exchangeInfo：500 權重／10 分鐘 | |
| WebSocket | 每個 IP 最多 20 條連線 | |
| 現貨 | 下單（單筆＋批次，按帳號） | 100 次／10 秒 |
| 撤單 | 80 次／10 秒或 200 次／分鐘 | |
| 其他 REST 端點（按 IP 權重） | 500 權重／10 秒 | |
| WebSocket | 每個 IP 最多 20 條連線 |
合約 IP 權重的單位，FAQ 寫「每 10 秒」，exchangeInfo 回傳的 rateLimits 卻是 interval: MINUTE, intervalNum: 10，兩者不一致。官方說 exchangeInfo 是限速的權威來源，保守起見按 10 分鐘 500 權重設計。每次回應都帶 X-USED-WEIGHT-*、X-REMAINING-WEIGHT-*（IP 權重）與 X-ORDER-COUNT-*、X-ORDER-REMAINING-*（下單次數）標頭，程式可以據此自動放慢。合約下單端點的說明另寫「每筆計入 10 秒與 1 分鐘兩個下單額度」，10 秒額度的數字文件沒有列。
收到 429 一定要停：官方寫明繼續送請求會被封鎖 10 秒。
哪些合約開放 API 交易
WEEX 的 API 交易對是另外一張清單。2026-10-17 查詢官方公開端點：exchangeInfo 列出 1,040 個合約（564 個加密貨幣永續、476 個股票等傳統資產永續），/capi/v3/market/apiTradingSymbols 只列了 298 個；現貨的 API 交易清單是 535 個。不在清單上的交易對，用 API 下單會回 -1052。上線策略前先呼叫這個端點確認，不要假設網頁上能交易的合約 API 也能下。
其他文件寫明的限制：交易對代號區分大小寫、一律大寫；WebSocket 連線必須帶 User-Agent 標頭，否則會被防火牆擋下回 403；目前不支援 TradingView 與 FIX API。
API 下單的手續費與返佣
費率：官方 exchangeInfo 顯示 BTCUSDT 永續 maker 0.02%、taker 0.08%，1,040 個合約裡有 913 個是這組費率；你帳號的實際費率可以用 GET /capi/v3/account/commissionRate 查。合約下單支援 POST_ONLY，只掛單不吃單，maker 費率是 taker 的四分之一。VIP 等級怎麼升見 WEEX VIP 等級；要注意 VIP8 規定 5 億 USDT 的合約量裡至少 4.5 億要是非 API 成交，API 為主的帳號衝不上最高級。
返佣：〈WEEX 聯盟計畫條款〉（2026-01-08 更新）第 5.1 條寫的是：佣金按被推薦人實際支付的交易手續費計算，扣除 WEEX 給特定客群的手續費折扣與「其他費用」；其他費用可能包括被推薦人使用第三方交易工具產生的費用。條款沒有把 API 下單排除，也沒有寫 API 下單一定計入，用 API 或第三方機器人交易的部分，以返佣明細為準。
另一個要分清楚的計畫：WEEX 的做市商計畫寫明申請的 UID 必須沒有任何返佣關係。也就是說，綁在邀請碼底下的帳號不符合做市商資格，想走做市商費率的，要另外準備帳號並直接寄信給 WEEX 申請。
試算：同樣 300 萬 USDT，吃單和掛單差多少
假設一支合約策略每月成交 300 萬 USDT，用 VIP0 掛牌費率與 Fee Otter 合約返佣 70% 計算：
| 情境 | 月手續費 | 退回 | 實付 |
|---|---|---|---|
| 全部吃單、不綁返佣 | 2,400 USDT | 0 | 2,400 USDT |
| 全部吃單＋常見 20% 碼 | 2,400 USDT | 480 USDT | 1,920 USDT |
| 全部吃單＋Fee Otter 70% | 2,400 USDT | 1,680 USDT | 720 USDT |
| 全部 POST_ONLY 掛單＋Fee Otter 70% | 600 USDT | 420 USDT | 180 USDT |
同樣成交量，全吃單不綁返佣要付 2,400 USDT，改成掛單再加 70% 返佣只要 180 USDT。限速方面，每分鐘 300 次下單平均每秒 5 次，一般網格或趨勢策略用不完；高頻撤改單的策略要注意撤單走的是 IP 權重，不是下單額度。
以上用官方掛牌費率估算，實際以成交紀錄與返佣明細為準。60% 由 WEEX 直接退回交易所帳戶，10% 由 Fee Otter 每天結算，可以在返佣比例頁看截圖。返佣只算交易手續費，資金費和強平不在範圍內。註冊步驟見 WEEX 註冊教學，已經用別人的碼註冊的見 WEEX 老用戶換綁教學，多家交易所的程式交易試算見 程式交易手續費返佣。
如果你本來就是交易所 VIP、或月交易量大的程式交易者，想換綁或註冊其他交易所，可以聯繫 Fee Otter 客服：我們會直接對接交易所官方窗口，幫忙申請特別的交易福利或更高的返佣比例，實際福利以交易所核定為準。
Telegram · @feeotter
