如何成为 WEEX 经纪商：申请、API 设置与正式上线

要成为 WEEX 经纪商，请提交 WEEX 经纪商页面上的入驻申请表，通过尽职调查审核，并获得一个格式为 WEEX 加 6 位数字的经纪商 ID。之后的工作主要是技术方面：通过 OAuth 或用户自己的 API 密钥关联用户，为每笔订单添加经纪商 ID 前缀，并通过返佣接口核对佣金。WEEX 给出的审批时间为 1 个工作日，正式上线需要 4 到 5 个工作日。以下各节按这一流程展开，列出需要准备的材料，并介绍保管他人密钥时需要采取的安全措施。信息截至 2026 年 10 月 7 日。

谁可以申请，以及 WEEX 的申请要求

个人、团队和公司均可申请，而且无需存入资金。WEEX 经纪商页面上的常见问题将量化团队、金融机构和社区 KOL 列为欢迎申请的对象，并说明审核属于标准尽职调查。

填写表格是最简单的一步。后续的 OAuth 注册需要提供更多信息，提前收集好这些材料可以节省数天时间：

• 平台名称，需使用英文
• 将与经纪商身份关联的 WEEX UID
• 隐私政策和服务条款的网址
• 平台 Logo
• 联系人及电子邮箱地址
• 一个或多个回调 URL
• 服务器发送请求所使用的公网 IP 地址

有两项要求容易让团队措手不及。申请前必须先拥有 WEEX 账户，因为注册时需要填写 UID。另外，隐私政策和服务条款必须是已上线的网页。

WEEX 经纪商申请时间线：从提交表格到获得经纪商 ID

1. 提交表格。点击经纪商页面上的“立即申请”按钮即可打开表格。
2. 等待审核。经纪商页面承诺会在 24 小时内联系申请者，并在“1 个工作日内审批”。经纪商 API 介绍则表示，商务拓展团队会在 3 个工作日内完成审核。建议按较长的时间安排计划。
3. 收到审批邮件。邮件中会包含一个经纪商 ID，例如 WEEX123456、初始佣金率配置，以及技术支持群的访问权限。
4. 获取 OAuth 凭证。WEEX 登记好你的回调 URL 和 IP 地址后，你会收到 clientId 和密钥。
5. 完成集成并上线。WEEX 的2026/07公告安排在第 2 至第 4 天进行技术集成，并于第 5 天上线。

实际安排中，日程与其说取决于 WEEX 的审核速度，不如说取决于你能多快提供稳定的回调 URL 和固定的出站 IP 地址。

关联用户：WEEX OAuth 七步流程

OAuth 允许用户在 WEEX 自有页面上授权你的平台，并向你的后端返回可直接使用的 API 密钥。OAuth 集成指南对流程作了如下说明。

1. 在后端生成一个只能使用一次、长度为 22 到 128 个字符的 state 值，以及一个 PKCE code_verifier，其长度为至少43。按 Base64URL(SHA256(code_verifier)) 计算挑战值。唯一接受的方法是 S256。
2. 将用户重定向至 https://www.weex.com/zh-CN/oauth，并附上你的 clientId、responseType=code、scope=create:apikey、state、redirectUri 和 code challenge。
3. 用户在 WEEX 上查看并批准授权。
4. WEEX 会将用户重定向至你的回调地址，并附上 code 和 state。请验证 state 是否与你生成的值一致。
5. 从后端向 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 编码所得的值。
6. 获取有效期为 3,600 秒的 access token，以及有效期为 36,000 秒的 refresh token。刷新后，之前的 access token 会失效。
7. 使用 bearer token 向 https://gateway.weex.com/v1/oauth/resource/create-api 发送 POST 请求。响应中会包含用户的 apiKey、secret 和 passphrase，这些信息只会返回一次。

有三项限制会影响方案设计。用户在同一个第三方平台下只能关联一个 API 密钥，第二次尝试会返回错误 81001：“api key already bound”（API 密钥已绑定）。来自未登记 IP 地址的请求会被拦截。如果用户的 API 状态不正常，新密钥可能无法立即使用，因此你的界面需要提供待处理状态。

OAuth 并非必需。平台也可以接受用户自行创建并粘贴的密钥。无论采用哪种方式，都必须按下文要求为订单添加标记。

标记订单并检查佣金资格

每笔订单都必须在 client order ID 前加上你的经纪商 ID：newClientOrderId 必须以 b-{brokerId} 开头，例如 b-WEEX123456-20260319001。现货和合约订单均适用此规则。

有两个细节很容易被忽略。现货订单接口中的 client order ID 是可选项；如果不填写，WEEX 会自动分配一个。因此，以这种方式发送的订单没有经纪商前缀，所以每次请求都要设置该字段。此外，长度限制存在冲突：经纪商介绍允许 64 个字符，而合约订单接口列出的范围是 1 到 36 个字符。前缀 b-WEEX123456- 占用 13 个字符。将 ID 其余部分设计为不超过剩余的 23 个字符，即可同时符合这两种限制。

接下来，使用经纪商返佣 API中的三个接口：

• 资格检查。GET /api/v3/apiReferral/checkUserEligibility 接收 WEEX UID，并返回用户是否符合资格、原因，以及账户是否已关联其他推荐码。用户关联时调用该接口并保存结果，不要将不符合资格的用户纳入佣金预测。
• 佣金比例。GET /api/v3/apiReferral/rebateRatio 会返回你的等级（BRONZE、SILVER 或 GOLD）和 6 个比例：现货与合约，分别适用于直接邀请用户、没有推荐码的用户，以及通过“邀请好友”产生的推荐用户。
• 记录。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 绝不能出现在前端代码中。经纪商常见问题还补充说明，密钥、secret 和 passphrase 绝不能通过 URL 参数传递。回调完成后，应重定向至干净页面，再由前端获取状态。
• 加密存储的密钥，并在日志中隐藏敏感信息。调试日志中出现完整 secret，是原本安全可靠的系统发生密钥泄露的最常见原因。
• 固定出站 IP 地址。WEEX 会拦截来自未登记地址的请求。如果更换云区域或添加代理时没有更新登记，所有用户都会同时无法使用服务。
• 考虑密钥只返回一次的情况。如果 create-api 成功后写入存储失败，密钥就会丢失，用户必须先删除密钥再重新关联。请将这一步设计为事务。
• 仅申请最低限度的权限。使用子账户方案时，任何超出只读权限的密钥都需要配置最多包含 10 项的 IP 白名单。只有当产品需要转移资金时，才申请 TRANSFER 或 WITHDRAW 权限。
• 遵守限制。REST 调用共享每 10 秒 500 的权重额度。遇到 HTTP 429 时应退避，并在授权失败次数激增时发出告警，因为这可能意味着泄露的凭证正在被尝试使用。

首位真实用户上线前检查清单

• 在测试账户上跑通完整流程：完成关联、资格检查返回 true、带标记的订单成交，并在下一次结算后于佣金记录中看到这笔交易。
• 通过佣金比例接口确认你的等级和比例，不要只凭宣传页面上的数字作假设。
• 分别在现货和合约环境中测试 client order ID 格式。
• 重放旧的 state 值和已使用过的授权 code。两者都应失败。
• 尝试从未登记的 IP 发起请求。请求应被拦截。
• 使用 WEEX 合约 API 常见问题中介绍的 /sim/ 路径下的模拟接口，在不动用真实资金的情况下测试订单逻辑。
• 编写支持处理手册。WEEX 文档列出了 support@weex.com 和 Telegram 社区，审批通过后还会提供技术支持群。

成为 WEEX 经纪商只需提交表格并通过简短审核；但要确保佣金准确到账，则需要严格标记订单、逐一检查用户资格，并每天运行对账任务。申请可从 WEEX 经纪商页面开始。

常见问题

1. WEEX 经纪商审批需要多长时间？

WEEX 经纪商页面承诺会在 24 小时内联系申请者，并在 1 个工作日内完成审批。其 API 文档则表示，商务拓展团队会在 3 个工作日内审核申请。根据 WEEX 的2026/07公告，之后的技术集成还需要约 4 到 5 个工作日。

2. 成为 WEEX 经纪商需要付费吗？

不需要。经纪商页面说明无需存入资金，申请也不收取费用。申请者需要通过标准尽职调查；获批后，经纪商可以免费使用经纪商后台和数据仪表盘。

3. WEEX 经纪商 ID 的格式是什么？

格式为 WEEX 后跟 6 位数字，例如 WEEX123456，并会随审批邮件一同发送。平台发送的每笔订单都必须在 client order ID 前加上 b- 和该 ID。

4. 平台可以不使用 OAuth 集成 WEEX 经纪商吗？

可以。用户可在 WEEX 上创建 API 密钥，再手动输入平台。OAuth 可以省去这一步手动操作；无论采用哪种方式，订单标记要求和佣金接口都相同。