WEEX API 速率限制:请求权重与 429 错误
WEEX API 速率限制:请求权重与 429 错误
WEEX API 限制取决于请求类型。REST API 使用基于 IP 的请求权重和基于账户的下单额度,而 WebSocket 连接和订阅也有各自的限制。要查找适用于你的集成方案的额度,请查看产品的 exchangeInfo、端点权重和响应标头。如果收到 HTTP 429,请先暂停受影响的请求,再调整请求频率。
即使机器人的流量看起来不大,也可能触及限制。市场数据服务、监控脚本和其他策略可能共用其出站 IP。了解共享额度,比为每个进程单独设置每秒请求数更有用。
请求次数、请求权重和订单限制有何不同?
| 请求类型 | 额度依据 | 实际影响 |
|---|---|---|
| 市场数据、账户查询及其他非下单端点 | 出站 IP 的请求权重 | 共用该 IP 的应用需要协调流量。 |
| 下单 | 账户的 userId 和 ORDERS 额度 | 调用会消耗文档中说明的订单额度。这些下单请求不会消耗 IP 权重。 |
请求权重不只是调用次数。权重为 10 的查询会消耗 10 个权重单位,而且某些端点的权重会根据请求参数变化。因此,根据所用端点不同,20 次调用消耗的额度也可能不同。
现货单笔和批量下单会使用订单额度。撤单和订单查询仍受 IP 限制。切换 API 密钥不会让同一应用获得新的 IP 额度。
在哪里可以查看当前额度?
现货和合约使用不同的交易所信息端点:
| 产品 | 查询地址 |
|---|---|
| 现货 | GET https://api-spot.weex.com/api/v3/exchangeInfo |
| 合约 | GET https://api-contract.weex.com/capi/v3/market/exchangeInfo |
在响应中找到 rateLimits,并一并查看其中的四个字段。rateLimitType用于标识额度类型,interval和 intervalNum定义时间窗口,limit则给出该窗口内的额度。
例如,在2026/11/04查询到的现货响应显示,REQUEST_WEIGHT为每 10 秒 500,ORDERS为每 10 秒 100。前一个数值表示权重单位,后一个表示订单额度。这些数值描述的是该现货配置快照,不应照搬到合约,也不应在应用中将其视为永久不变的常量。
请查询合约端点以获取合约限制。如果其响应与常见问题解答或端点参考文档不一致,请保留响应内容和查询时间,以便 API 支持团队在你调整生产流量前确认规则。
应用运行期间使用响应标头跟踪用量
IP 响应会通过 X-USED-WEIGHT-(intervalNum)(intervalLetter)和 X-REMAINING-WEIGHT-(intervalNum)(intervalLetter)报告已用和剩余权重。例如,X-USED-WEIGHT-1M表示当前 IP 在一分钟窗口内已使用的权重。
下单使用 X-ORDER-COUNT-(intervalNum)(intervalLetter)和 X-ORDER-REMAINING-(intervalNum)(intervalLetter)。请记录实际返回的时间间隔名称,以便判断应用即将触及哪项限制。
多个服务共用一个 IP 或账户时,可以考虑集中管理它们的额度。为订单查询、撤单和故障恢复预留容量,以便在市场数据流量增加时,这些操作仍有余量。
遇到 HTTP 429 时应如何恢复?
暂停触及限制的请求队列,并检查响应标头和时间窗口。然后逐步延长重试间隔,并加入随机抖动,避免多个工作进程同时恢复、立刻再次触及相同限制。应根据适用的时间窗口选择延迟,而不要对所有请求都使用同一个固定值。
接下来,追踪流量。检查是否存在重复轮询、不必要的全量数据查询,或共用 IP 但分别跟踪额度的机器人。只降低一个进程的速度,可能并不会减少整体流量。
官方访问限制说明,超出限制会返回 429,持续违规则会导致 10 秒封禁。封禁时长并不意味着等待固定的 10 秒后就一定能恢复。如果订单请求也发生超时或结果不明确,请在重新发送前查询订单状态,以免重复下单。
哪些 WebSocket 限制是独立计算的?
现货和合约的 WebSocket 文档列出了以下限制:每个 IP 每 5 分钟最多发起 300 次连接请求;每个 IP 最多同时建立 20 个连接;每个连接每小时最多执行 240 次订阅操作;每个连接最多订阅 100 个频道。
这些限制衡量的是连接或订阅活动,并不表示服务器每小时最多只能推送 240 条市场或订单更新。复用连接、维护订阅注册表并处理心跳,可以减少不必要的连接尝试和订阅。故障后重新连接时也应采用退避策略。
即使使用 CCXT 或 SDK,这些额度仍然重要,尤其是在多个应用共用一个 IP 或账户时。如果观察到的限制与预期不同,请使用官方 API 常见问题中的支持链接。请提供端点、时间戳、状态码和经过脱敏处理的响应标头,以便排查问题。