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
