WEEX API 速率限制详解：新手易忽略的关键数字

WEEX API 速率限制规定了您的代码在特定时间窗口内可发送的请求数量——例如每分钟 100 个现货订单、每分钟 50 个合约订单、每 2 秒 20 次公共市场数据调用——一旦超出限制，服务器将返回 HTTP 429 错误并实施短暂封禁。大多数关于交易所速率限制的指南仅停留在概念层面。本文将为您揭示 WEEX 的实际限额、基于 IP 与账户的限制差异，以及计算新手机器人触及这些限制的速度。

以下所有数据均来自 WEEX 现货与合约 API 文档，最后更新于 2026-04-14。速率限制会随系统升级而调整，请以官方文档为准，本文仅供参考。

什么是 WEEX API 速率限制，交易所为何设置此限制？

速率限制是对请求频率的上限约束。如果在测量窗口内发送的调用次数超过限制，服务器将停止响应——在 WEEX 上，会返回 HTTP 状态码 429 Too Many Requests。

这并非出于吝啬。交易所撮合引擎服务于所有用户，单个配置错误的循环程序若每秒轮询价格 200 次，将给其他用户的成交带来实际成本。限制措施还能有效遏制订单垃圾邮件操纵。如果您曾使用 WEEX API 进行自动化交易，无论您是否察觉，您一直都在这些预算范围内运行。

对新手而言，实用的理解方式是：将速率限制视为一种基于定时器重置的“消费额度”，而非简单的开关。您的任务是设计请求预算，而不是在账户被限流后再做出反应。

按端点划分的 WEEX API 速率限制：关键数字

这是大多数速率限制文章忽略的部分。以下是按业务类型发布的 WEEX 限制。

表中的四个细节常让人困惑。首先，现货和合约的订单限制不同——100/分钟对 50/分钟——因此从一个市场移植到另一个市场的策略不会继承其安全边际。其次，撤单额度有两种形式：每 10 秒 80 次允许您以每秒 8 次的速度突发，但每分钟 200 次意味着您无法维持该速度。第三，连接限制与请求限制是分开的；您可能远未达到订单预算，但因打开过多套接字而被屏蔽，且 WebSocket 文档规定了每个 IP 最大 100 个并发连接和每个连接 100 个频道的硬性上限。

第四，批量处理是适用的情况下最经济的优化手段。合约访问限制页面指出，包含四个交易对且每个交易对十个订单的批量订单计为一个请求。话虽如此，各个端点页面会发布自己的每请求上限和权重，且并不总是与一般指南一致——因此请检查您调用的特定端点，而不是假设批量处理总是免费的。

WEEX 还指出，每个端点的速率限制是独立计算的，并标记在其各自的文档页面上。不要假设存在全局池。特别是现货 V3 版本，通过端点 IP 权重而非固定请求数来计量市场数据，因此每个端点页面上的权重数字才是限制您的关键。

WEEX 限制是按 IP 还是按账户执行？

取决于您调用的内容——两者混淆是导致“我没超限，为什么被限流？”工单的最常见原因。

携带有效 API 密钥的请求根据密钥或账户 (userId) 进行计量。无密钥的请求（公共市场数据）则根据您的公共 IP 地址进行计量。

现货 V3 API 进一步明确了这一点。除下单外的每个端点都通过权重系统按 IP 进行速率限制，其中较重的端点每次调用消耗更多的预算。下单端点则在您的账户下按 ORDERS 类型计量，根据 现货访问限制文档，它们不消耗 IP 权重——尽管某些单独的端点页面仍列出了 IP 权重，因此请阅读您实际调用的端点页面。

操作上的后果很容易被忽略：从一台云虚拟机运行三个机器人会共享一个市场数据 IP 预算，无论您持有多少个独立的 API 密钥。反之，将订单流转移到第二台服务器对账户级的订单上限毫无帮助。

如何在触发 429 之前读取 WEEX 速率限制响应头

每个响应都会告诉您剩余的预算。新手几乎从不读取这些响应头，这就是为什么麻烦的第一个迹象通常是错误而非警告。

间隔字母为 S、M、H、D，分别代表秒、分、时和天，因此 X-USED-WEIGHT-1M 是您的 IP 在过去一分钟内消耗的权重。在每次响应中记录这些数据，您就能将隐形约束转化为可监控的指标——当剩余权重降至例如 20% 以下时暂停，而不是等待服务器拒绝。

WEEX 上的 429 错误代价

超出限制并非免费重试。请求会以 429 失败，现货文档指出违反限制会导致 10 秒封禁。如果您持有杠杆头寸且撤单调用被拒绝，10 秒就是永恒。

二阶风险更严重。WEEX 指出，触发平台风险控制的账户——包括持续高频的无效请求——可能会被自动禁用 API 权限，重新激活需要提交工单。一个不断敲击失败端点的重试循环不仅会被限流，还可能被视为攻击。

两种相关的失败模式会导致新手误读为速率限制。ACCESS-TIMESTAMP 与服务器时间偏差超过 30 秒的请求会被直接拒绝（错误 -1046），在时钟漂移时看起来像随机间歇性故障。而没有 User-Agent 头的 WebSocket 连接会被防火墙以 403 拦截，而非 429——修复方法是添加响应头，而不是减慢循环。

新手消耗 WEEX API 速率限制的四种方式

这里的算术部分非常有用，因为限制在您乘法计算之前看起来很慷慨。

单独轮询每个品种。 每秒请求 50 个品种的行情是每秒 50 次独立调用，是 20 次/2 秒公共额度允许的每秒 10 次节奏的五倍——且永久超限。大多数市场数据端点接受品种列表，因此同一任务通常只需一次调用。更好的是，将其移至推送更新的 WebSocket 流，而不是您主动询问。

网格重报价过快。 一个每 10 秒取消并替换每一层的 20 层网格每分钟产生 120 次下单。这超过了现货 100 次的上限，且是合约 50 次上限的两倍多。将重报价间隔延长至 30 秒即可使同一策略处于两者限制之内。

重连风暴。 在紧密循环中掉线并立即重试的 WebSocket 客户端可能在不到一分钟内耗尽每 5 分钟 300 次连接的 IP 预算。每次重连都需要退避和抖动延迟，而不是立即重试。

重试 429 本身。 最昂贵的错误是将 429 视为瞬时网络错误并立即重试。WEEX 明确规定，收到 429 时您有责任停止。指数退避——每次等待时间翻倍、设置上限、添加抖动——是标准答案，也是交易所期望的做法。

如何构建一个保持在 WEEX API 速率限制内的机器人

在编写策略之前先设计预算。确定逻辑实际需要的每分钟订单数，与上表中的上限进行比较，并留出 30–40% 的余量，以应对机器人自然想要进行更多交易时的波动高峰。

然后按任务拆分传输。REST 用于离散操作——下单、撤单、查询余额。WebSocket 用于原本需要轮询的操作：订单簿更新、行情、成交。将市场数据移至流通常可以在一次更改中消除机器人大部分的请求量，同时降低延迟。

添加客户端速率限制器，而不是依赖服务器告诉您不行。设置略低于发布限制的令牌桶意味着您的代码会排队处理多余请求，而不是招致封禁。记录每个 429 及其端点和时间戳，以便查看哪个调用才是罪魁祸首——通常不是您怀疑的那个。

最后，在实验时保持权限紧凑。将 API 密钥范围限制在机器人所需范围内，启用 IP 白名单，并记住新创建或修改的密钥需要大约 15 分钟才能在系统中传播，因此密钥创建后立即出现的身份验证失败通常是传播问题而非编码错误。每个市场的端点级详细信息位于 WEEX 现货 API 常见问题解答 和 WEEX 合约 API 常见问题解答 中。

关于 WEEX API 速率限制的总结

WEEX API 速率限制不是要绕过的障碍；它们是区分能在波动行情中存活的机器人与在波动中被封禁的机器人的设计约束。学习管理您策略的三个数字——订单上限、公共数据上限和连接上限——配置响应头以便查看剩余预算，并在收到 429 时正确退避。这就是大部分工作。

准备好针对真实端点测试策略了吗？在您的 WEEX 账户中创建一个 API 密钥，从只读权限和一个品种开始，并在启用交易范围之前确认您的请求核算正确。

常见问题解答

1. 如果我超过了 WEEX API 速率限制会怎样？

请求会以 HTTP 状态码 429 Too Many Requests 失败，现货文档指出违反限制会导致 10 秒封禁。持续的高频无效请求也可能触发平台风险控制，这可能会禁用 API 权限，直到您联系支持人员。

2. WEEX API 速率限制是按 IP 地址还是按 API 密钥？

两者皆有。需要 API 密钥的端点根据账户进行计量，而无需密钥的公共端点则根据您的 IP 进行计量。在 V3 现货 API 中，下单由账户 (userId) 在 ORDERS 类型下限制，其余均按 IP 权重限制。

3. 我在 WEEX 上每分钟可以下多少订单？

截至 2026-04-14 更新的文档，现货允许每分钟 100 次下单，合约允许每分钟 50 次。现货撤单限制为每 10 秒 80 次或每分钟 200 次；合约撤单为每分钟 50 次。

4. WebSocket 是否计入 WEEX REST 速率限制？

不直接计入，但 WebSocket 有自己的预算：每 IP 每 5 分钟 300 次 REST/WS 连接请求，最大 100 个并发连接，以及每个连接每小时 240 次频道订阅，最大 100 个频道同时打开。将市场数据移至 WebSocket 是减少 REST 请求量的最有效方法。

5. 为什么即使在速率限制内我也会收到错误？

在假设限流之前检查三件事。与服务器时间偏差超过 30 秒的时间戳会被拒绝为 -1046。没有 User-Agent 头的 WebSocket 连接会返回 403。新创建或修改的 API 密钥需要大约 15 分钟才能在全系统传播。

6. 批量订单在 WEEX 上算作一个请求吗？

合约访问限制页面指出，涵盖四个交易对且每个交易对十个订单的批量订单计为一个请求，这使得批量处理成为扩展有限预算的经济方式。不过，各个端点页面会发布自己的每请求上限和权重，且并不总是与一般指南一致——在调整批量大小之前，请针对您调用的端点进行验证。

风险提示

加密资产波动剧烈，交易可能导致部分或全部资本损失。API 和自动化交易增加了手动交易不具备的风险：速率限制封禁可能导致您在快速行情中无法撤单或平仓，重连失败可能导致策略对成交视而不见，编码错误可能在几秒钟内执行意外规模的交易。杠杆合约放大了所有这些结果，并可能导致清算。泄露的 API 密钥存在直接托管风险——将权限范围限制在最小必要范围内，启用 IP 白名单，切勿共享密钥或机密。速率限制、端点和错误代码可能会随系统升级而改变；在部署前务必对照当前的官方 WEEX API 文档进行验证。本文内容不构成投资建议。