परिभाषा
Rate limit
A cap on the number of requests an API will accept in a window.
Definition
An API rate limit is a cap on the number of requests an API will accept in a given time window. Clients that exceed the limit receive an error or are temporarily blocked until the window resets. Rate limits protect servers from overload, ensure fair usage among clients, and preserve quality of service.
In context
On Polymarket the Gamma surface publishes public REST endpoints such as /markets. That endpoint specifically allows 300 requests per 10 seconds. Combined listing usage across /markets and /events has a larger combined limit (900 requests per 10 seconds). Exceeding these limits will cause the API to reject further requests until the relevant window expires; plan pagination and polling intervals accordingly.
Practical tips
- Use keyset pagination (after_cursor) rather than offset to page efficiently through /markets.
- Batch requests where possible and avoid tight polling loops; prefer sensible backoff after hitting a limit.
- Cache repeated responses for short intervals if your workflow can tolerate slightly stale data.
See also
- gamma-api