定义
速率限制
API 在一个时间窗口内接受请求数量的上限。
Definition
API 速率限制是对在给定时间窗口内 API 可接受请求数量的上限。超过限制的客户端会收到错误或在窗口重置之前被暂时阻止。速率限制用于防止服务器过载、确保客户端之间的公平使用,并维持服务质量。
In context
在 Polymarket 上,Gamma surface 发布了诸如 /markets 的公共 REST 端点。该端点特别允许在 10 秒内发出 300 次请求。/markets 与 /events 的合并列表调用有更大的联合限制(在 10 秒内 900 次请求)。超出这些限制会导致 API 拒绝进一步请求,直到相关窗口到期;因此请相应地规划分页和轮询间隔。
Practical tips
- 使用键集分页(after_cursor)而不是 offset,以高效遍历 /markets。
- 在可能的情况下批处理请求并避免紧密的轮询循环;在触及限制后应采用合理的退避策略。
- 如果工作流能容忍短时间的数据陈旧,请对重复响应进行短期缓存。
See also
- gamma-api