如何成為 WEEX 經紀商：申請、API 設定與正式上線

By: WEEX|2026/10/07 04:00:00

要成為 WEEX 經紀商，請提交 WEEX 經紀商頁面提供的入駐表單、通過盡職調查審核，並取得格式為 WEEX 加上六位數字的經紀商 ID。接下來便是技術工作：透過 OAuth 或使用者自己的 API 金鑰連結使用者、在每筆訂單前加上經紀商 ID，並透過返佣端點核對佣金。WEEX 表示審核需要 1 個工作日，正式上線則需 4 至 5 個工作日。以下各節依照此流程排列，列出需要準備的資料，並說明保管他人金鑰時須進行的安全工作。資訊截至 2026 年 10 月 7 日。

誰可以申請，以及 WEEX 要求哪些資料

個人、團隊和公司皆可申請，且無須存入資金。WEEX 經紀商頁面上的常見問題列出量化團隊、金融機構及社群 KOL 為歡迎申請的對象，並說明審核內容為標準盡職調查。

表單是最簡單的部分。接下來的 OAuth 註冊需要提供更多資料，提早準備好可以省下好幾天：

平台名稱，須使用英文
要連結至經紀商身分的 WEEX UID
隱私權政策和服務條款的網址
平台標誌
聯絡人及電子郵件地址
一個或多個回呼網址
伺服器傳送請求時使用的公用 IP 位址

有兩項容易讓團隊措手不及。申請前必須先擁有 WEEX 帳戶，因為註冊時需要填寫 UID。此外，隱私權政策和服務條款必須是已上線的網頁。

WEEX 經紀商申請時程：從表單到經紀商 ID

提交表單。經紀商頁面上的「立即申請」按鈕會開啟表單。
等待審核。經紀商頁面承諾會在 24 小時內聯絡申請者，並於「1 個工作日內核准」。經紀商 API 介紹則表示，業務拓展團隊會在 3 個工作日內完成審核。建議按較長的時程規劃。
收到核准電子郵件。郵件中會提供經紀商 ID，例如 WEEX123456、初始佣金費率設定，以及技術支援群組的存取權限。
取得 OAuth 憑證。WEEX 註冊好你的回呼網址和 IP 位址後，你便會收到 clientId 和密鑰。
完成整合並啟動服務。WEEX 的2026/07公告將技術整合安排在第 2 至第 4 天，並於第 5 天正式上線。

實際上，時程與其說取決於 WEEX 的審核速度，不如說取決於你方能多快提供穩定的回呼網址和固定的對外 IP 位址。

連結使用者：WEEX OAuth 流程的七個步驟

OAuth 讓使用者能在 WEEX 自家的頁面授權你的平台，並將可直接使用的 API 金鑰傳回你的後端。OAuth 整合指南說明的流程如下。

在後端產生一次性 state 值，長度為 22 至 128 個字元，並產生 PKCE code_verifier 至少43。使用 Base64URL(SHA256(code_verifier)) 計算 challenge。唯一接受的方法為 S256。
將使用者重新導向至 https://www.weex.com/zh-TW/oauth，並附上你的 clientId、responseType=code、scope=create:apikey、state、redirectUri 和 code challenge。
使用者在 WEEX 查看並核准。
WEEX 會將使用者重新導向至你的回呼網址，並附上 code 和 state。請確認 state 與你發出的值相符。
從後端向 https://gateway.weex.com/v1/oauth/token 傳送 POST 請求，並附上 code、redirectUri 和 code verifier。請求須帶有 Client-Id、Sign、Timestamp 和 Nonce 標頭，其中 Sign 是以你的 client secret 為金鑰，對 timestamp、nonce、method、path 和 body 執行 HMAC-SHA256 後再以 Base64 編碼所得的值。
取得有效期為 3,600 秒的 access token，以及有效期為 36,000 秒的 refresh token。重新整理時，先前的 access token 會失效。
使用 bearer token 向 https://gateway.weex.com/v1/oauth/resource/create-api 傳送 POST 請求。回應會包含使用者的 apiKey、secret 和 passphrase，且這些資料只會回傳一次。

有三項限制會影響系統設計。每位使用者在同一個第三方平台只能綁定一個 API 金鑰，第二次嘗試會收到錯誤 81001：「api key already bound」。來自未註冊 IP 位址的請求會遭到封鎖。此外，如果使用者的 API 狀態不是正常狀態，新金鑰可能無法立即使用，因此你的介面需要提供待處理狀態。

OAuth 並非必要。平台也可以接受使用者自行建立並貼上的金鑰。無論採用哪種方式，都必須依照下文說明為訂單加上標記。

-- 價格

為訂單加上標記並確認佣金資格

每筆訂單都必須在 client order ID 的開頭加上你的經紀商 ID：newClientOrderId 必須以 b-{brokerId} 開頭，例如 b-WEEX123456-20260319001。現貨和期貨訂單皆適用此規則。

有兩個細節容易被忽略。現貨訂單端點的 client order ID 為選填；若未填寫，WEEX 會自行指派一個 ID。這種訂單不會有經紀商前綴，因此每次請求都要設定此欄位。此外，長度限制並不一致：經紀商介紹頁允許 64 個字元，而期貨訂單端點列出的範圍為 1 至 36 個字元。前綴 b-WEEX123456- 共占 13 個字元。將其餘 ID 設計為不超過剩餘的 23 個字元，便符合兩種說法。

接著使用經紀商返佣 API中的三個端點：

資格。GET /api/v3/apiReferral/checkUserEligibility 接受 WEEX UID，並回傳使用者是否符合資格、原因，以及帳戶是否已連結至其他推薦碼。使用者連結時呼叫此端點並儲存結果，且不要將不符合資格的使用者納入佣金預測。
費率。GET /api/v3/apiReferral/rebateRatio 會回傳你的等級（BRONZE、SILVER 或 GOLD）和六種比例：直接邀請對象、沒有推薦碼的使用者，以及「邀請好友」推薦對象各自的現貨和期貨比例。
紀錄。GET /api/v3/apiReferral/rebate/recentRecord 會依交易對和佣金幣種回傳佣金紀錄，預設查詢 SPOT，也可以查詢 FUTURES。查詢範圍最長為 90 天，單頁最多 100 筆。

紀錄會按交易對和結算期間回傳，並包含交易金額、手續費、手續費扣減、返佣比例及佣金等欄位，但不包含使用者 ID 或訂單 ID。若要按使用者拆分佣金，例如與策略作者分享收益，請自行建立以 client order ID 為索引的訂單帳本。經紀商頁面表示，佣金每日結算。

經紀商 API 金鑰安全：保管他人的金鑰

第一位使用者連結帳戶後，你的資料庫就會存有能用於真實資金交易的憑證。WEEX 文件列出最低安全要求，謹慎的經紀商則會採取更多措施。

將密鑰保留在後端。OAuth 指南指出，client secret、code verifier，以及每位使用者的 secret key 和 passphrase 絕不能出現在前端程式碼中。經紀商常見問題也補充，金鑰、密鑰和 passphrase 絕不可透過 URL 參數傳送。收到回呼後，請重新導向至乾淨的頁面，並讓前端取得狀態。
加密儲存的金鑰，並在日誌中遮蔽金鑰。在其他方面完善的系統中，除錯日誌包含完整密鑰是金鑰外洩最常見的原因。
固定對外 IP 位址。WEEX 會封鎖來自未註冊位址的請求。若變更雲端區域或新增代理伺服器，卻未更新註冊資料，所有使用者會同時無法使用服務。
妥善處理僅回傳一次的資料。如果 create-api 成功後，寫入儲存空間卻失敗，密鑰便會遺失，使用者必須刪除金鑰並重新連結。請將此步驟設計為交易流程。
只要求最低限度的權限。在子帳戶流程中，任何超出唯讀的金鑰都需要設定最多包含 10 個項目的 IP 允許清單。只有在產品需要轉移資金時，才要求 TRANSFER 或 WITHDRAW 權限。
遵守限制。REST 呼叫共用每 10 秒 500 的權重限制。遇到 HTTP 429 時應降低請求頻率，並在授權失敗突然增加時發出警示，因為這可能表示有人正在測試外洩的憑證。