将交易机器人连接到 WEEX API：12 点风险检查清单

将交易机器人连接到 WEEX API，涉及权限决策、速率限制决策和故障处理决策，而大多数机器人损失都源于这三者中的某一项被忽略。下面的清单涵盖机器人首次下单前值得确认的 12 项内容：API 密钥的权限范围和绑定方式、机器人如何应对 WEEX 的单 IP 权重限制与单账户订单限制、时钟漂移或连接断开时会发生什么、如何停止机器人，以及 9 月 30 日之后它是否仍在使用有效的 API 版本。每一点都说明需要检查什么、为什么这在 WEEX 上尤其重要，以及完成后应达到什么状态。先在模拟账户上完整执行一遍清单；合约 API 的模拟端点让这一过程非常简单。

密钥与权限检查（1–4）

1. 密钥的权限范围恰好满足机器人的需要。 WEEX 密钥默认是只读权限，也可以携带现货或期货/合约交易权限。现货网格机器人使用现货权限；永续合约机器人使用期货/合约权限；两者都不应同时拥有。WEEX 没有提现权限范围，这消除了最糟糕的情况，但把交易密钥授予错误的市场，仍可能让机器人损失你本不想暴露的资金。完成标准：密钥权限列表只显示一个交易权限范围。

2. 密钥绑定到了机器人的 IP。对于自托管机器人，应绑定 VPS 的静态地址。对于托管机器人平台，应绑定平台公布的出站流量 IP 地址；如果平台无法提供稳定的地址列表，这意味着你应重新考虑该平台，而不是让密钥保持开放。WEEX 文档将未绑定的密钥描述为安全风险。完成标准：来自任何其他 IP 的测试调用都会被拒绝。

3. 密钥专用于这个机器人。在 WEEX 允许的 10 个密钥组中，每个机器人、每台机器使用一个密钥。当出现问题时，你会希望撤销一个机器人而不停止其他机器人，也会希望订单历史记录能显示每个机器人执行了什么操作。完成标准：密钥名称能够识别机器人和主机。

4. Secret 和口令存放在密钥管理存储中。不能放在机器人的源代码中，不能放在截图里，也不能放在平台客服聊天中。口令无法找回，因此应与 SecretKey 一起保存。完成标准：重新克隆机器人的代码仓库后，其中不包含任何凭据。

速率限制与时钟检查（5–7）

5. 机器人读取WEEX 的速率限制响应标头。大多数 REST 端点按 IP 以权重限制；下单则在 ORDERS 计数桶下按账户限制。超出任一限制都会返回 HTTP 429，并触发 10 秒封禁。对于加权端点，响应会在秒、分钟、小时和日等时间区间提供 X-USED-WEIGHT 与 X-REMAINING-WEIGHT；对于订单端点，则提供 X-ORDER-COUNT 与 X-ORDER-REMAINING。当剩余额度较低时主动退避的机器人不会触发封禁；收到 429 后继续重试的机器人则会延长封禁。完成标准：日志显示机器人在 429 之前就主动限流，且 429 会触发暂停而不是重试循环。

6. 同一 IP 上的多个机器人共享一个额度。由于权重限制按 IP 计算，同一 VPS 上的 3 个机器人会争用同一份额度；只有在它们使用不同账户运行时，各自才拥有独立的账户订单额度。完成标准：你已汇总主机上每个进程的轮询速率，并确认总量处于 IP 额度内且留有余量。

7. 主机时钟已同步。 WEEX 会拒绝时间戳与服务器时间相差超过 30 秒的请求。时钟漂移会造成间歇性身份验证失败，看起来像是密钥问题；更糟糕的是，它可能让机器人无法取消已经提交的订单。完成标准：NTP 正在运行，机器人会在启动时以及任何时间戳被拒绝后获取服务器时间。

订单处理与故障检查（8–10）

8. 订单具备幂等性。每个订单请求都携带一个根据交易信号确定性生成的 newClientOrderId，因此超时后的重试不会造成重复成交。WEEX 接受长度为 1 至 36 个字符、且使用受限字符集的客户订单 ID。完成标准：在请求进行中终止机器人并重启，不会产生重复订单。

9. 机器人以交易所状态为准，而不是自己的记忆。每次重新连接或重启后，机器人都会从 WEEX 查询持仓和未完成订单，并将其视为事实。崩溃后仍信任内部账本的机器人，可能会对冲一个已经不存在的持仓，或留下一个它以为已经关闭的持仓。完成标准：在有持仓期间强制重启后，机器人能在一个轮询周期内恢复正确状态。

10. 存在一个你真正测试过的紧急停止开关。需要两层。机器人内部：设置最大持仓量、最大每日亏损和最大下单速率，任何一项超限都会停止交易并取消未完成订单。机器人外部：你知道在 WEEX 的 API 管理页面删除 API 密钥可以立即停止机器人，并且已经在模拟环境中执行过一次，以观察密钥失效后的机器人行为。完成标准：两层机制都被有意触发过，机器人能够干净地停止。

平台与生命周期检查（11–12）

11. 机器人使用当前的 API 版本。WEEX 的期货 API 文档显示 V2 将于 9 月 30 日停止服务，当前版本为 V3。仍指向 V2 端点的托管平台或旧版开源连接器可能会停止工作，并且此时持仓可能仍处于开启状态。完成标准：机器人调用的每个端点都是 V3 路径，或者平台已书面确认其 WEEX 连接器为 V3。

12. 整份清单已在模拟环境中通过。WEEX 期货 API 提供模拟端点，包括POST /capi/v3/sim/order和 GET /capi/v3/sim/balance；它们使用与实盘相同的身份验证和签名，并以模拟 SUSDT 结算。让机器人在模拟环境中运行足够长的时间，以观察重启、速率限制警告、止损触发和密钥撤销。完成标准：机器人已在模拟环境中连续完整运行至少 1 周，错误日志干净；切换到实盘只是将 /sim/ 改为实盘路径并更换密钥的配置变更，而且已经由人工复核。

托管平台还是自行构建：风险有何不同

这份清单适用于两种方式，但薄弱环节会发生变化。

托管机器人平台会替你处理工程问题（速率限制、状态核对和版本迁移），但会带来交易对手风险：你的密钥存储在对方基础设施上，对方遭到入侵就可能暴露其持有的每一把密钥。可通过绑定到对方公布的 IP 地址、采用最小权限，以及停止使用平台后立即轮换密钥来降低风险。连接前应询问两个问题：他们是否公布稳定的出站 IP，以及其 WEEX 连接器是否为 V3。

自行构建机器人消除了交易对手风险，但清单中的每一项工程工作都由你承担。人们最容易跳过的是第 7、8、9 和 10 项，因为它们只在故障时才重要，而模拟账户正是低成本验证这些故障的地方。为紧急停止开关预留的时间应多于为策略预留的时间。

有经验的运营者会关注什么

大多数并非策略失败造成的机器人崩溃，都符合两种模式。第一种是无声重试循环：网络短暂中断、收到 429、从未实现的指数退避，以及一个在 10 秒封禁期间持续轰击下单端点的机器人，同时它的止损取消请求还在队列中。第二种是过期密钥：一个数月前已经停用的机器人，其期货/合约密钥从未删除，仍然有效且未绑定。第 5 项可以防止第一种情况；第 3 项加上每季度一次的 API 管理审计可以防止第二种情况。两者都不需要任何高深技巧，只需要真正执行。

常见问题

1. 将交易机器人连接到 WEEX API 安全吗？

安全程度取决于密钥是否仅限一个市场、已绑定 IP、专用于该机器人，以及机器人是否能处理速率限制、时钟漂移、幂等性和状态核对。WEEX 密钥无法提现，这排除了最糟糕的结果，但不能排除交易损失。

2. 机器人在 WEEX 上需要什么 API 权限？

现货机器人需要现货交易权限；期货机器人需要期货/合约权限。只监控的机器人需要只读权限。绝不要在同一个密钥上同时启用两种交易权限。

3. 如果机器人超过 WEEX 速率限制，会发生什么？

API 会返回 HTTP 429 并实施 10 秒封禁。订单端点按账户限制；大多数其他端点按 IP 以权重限制。读取 X-USED-WEIGHT 和 X-ORDER-COUNT 响应标头，以保持在限制以内。

4. 我可以在不使用真实资金的情况下测试 WEEX 机器人吗？

可以。期货 API 在 /capi/v3/sim/ 下提供模拟端点，使用实盘身份验证并以模拟资金结算；模拟终端还能让你实时查看机器人的订单。

5. WEEX API V2 停止服务是什么意思？

WEEX API 文档列出 V2 将于 9 月 30 日停止服务，当前版本为 V3。仍使用 V2 端点的机器人和平台需要在此之前完成迁移。

6. 如何立即停止机器人？

在 WEEX 的 API 管理页面删除其 API 密钥；机器人会立即失去访问权限。然后手动取消未完成订单并检查持仓。同时也应构建内部紧急停止开关，让机器人能在亏损或持仓规模超限时自行停止。

风险提示

通过交易所 API 进行自动交易，会将市场风险与运营风险结合起来。杠杆期货持仓可能迅速被清算，而机器人漏洞、网络故障、速率限制封禁、时钟漂移或 API 密钥泄露，都可能以任何人类交易者都不会选择的方式提交订单或未能取消订单，从而造成无法挽回的损失。第三方机器人平台还会为你的 API 凭据增加交易对手风险。加密货币价格波动剧烈，你可能损失机器人控制的部分或全部资金。本文对 WEEX API 行为、限制和版本时间表的描述截至 2026 年 9 月，相关内容可能发生变化；本文不构成投资建议。