这些按签名者地址实施的限制与现有的 Cloudflare IP
限制相互独立,且后者保持不变。
速率限制的工作方式
每个签名者都有一个订单令牌桶和一个取消令牌桶:令牌补充与突发容量
令牌按照当前等级的速率持续补充。突发容量是令牌桶可以持有的最大令牌数。满桶可以立即消耗全部突发容量;突发容量用尽后,新令牌按补充速率恢复。 完整突发容量对应的持续时间为:批量请求
正式启用限流后,只有当令牌桶中的令牌足以覆盖批次中的每个条目时,系统才会接受该批次。否则,整个请求会被拒绝,不会处理任何条目。此全有或全无规则仅适用于速率限制检查;通过检查的批次仍保留正常的逐订单响应行为。 如果一个批次的令牌消耗超过当前等级的突发容量,则无法以单个请求的形式被接受。请将其拆分为更小的批次。取消所有订单和取消市场订单
系统无法在DELETE /cancel-all 或 DELETE /cancel-market-orders 开始时预先知道将取消多少订单。每个请求会先消耗一个取消令牌。得知取消结果后,每成功取消一个订单,取消令牌桶中还会再扣除一个令牌。
对于允许取消令牌余额为负的等级,第二次扣除可能使取消令牌桶产生欠额。后续取消请求会被阻止,直到令牌桶中有足够令牌处理下一个请求。其他等级会将取消令牌余额下限设为零,无论扣除数量多大。
交易量等级
令牌桶按签名者地址划分。等级资格取决于账户钱包(即 maker 钱包)的累计交易量,即使账户钱包与签名者地址不同。当前交易量窗口为 30 天,等级分配每三小时刷新一次。
随着系统调整,等级阈值、交易量窗口和速率限制可能会发生变化。Polymarket 将提前通知任何重大变更。
响应头
当限流器成功评估上述请求时,响应会包含以下响应头:
以下响应头仅在特定情况下出现:
Poly-RateLimit-Reset 并不表示令牌桶恢复至满容量的时间。对于令牌消耗未超过突发容量的 429 响应,它表示预计何时会有足够令牌处理该请求。对于已接受的请求,它可能是当前时间戳。
对于允许取消令牌余额为负的等级,DELETE /cancel-all 或 DELETE /cancel-market-orders 执行后,Poly-RateLimit-Remaining 可能为负数。发送大批量请求前,请将其令牌消耗与剩余余额进行比较。
处理 429 响应
正式启用限流后,如果请求所需的令牌多于适用令牌桶中的可用令牌,系统将返回429 Too Many Requests。
如果请求的令牌消耗未超过当前等级的突发容量,Retry-After 会给出重试前的最短等待时间。你无需等待桶完全补满。如果请求的令牌消耗超过突发容量,请将其拆分为更小的请求,而不是原样重试。