Rate Limits

Understanding API rate limits and how to handle them

Rate Limits

API rate limits vary by plan. Limits are enforced on a per-day basis and reset at midnight UTC.

Limits by plan

Plan	Requests/min	Requests/day
Starter (Free)	60	1,000
Pro	300	50,000
Enterprise	Custom	Unlimited

Rate limit headers

Every API response includes rate limit headers:

Header	Description
X-RateLimit-Limit	Your daily request limit
X-RateLimit-Remaining	Requests remaining today
X-RateLimit-Reset	Unix timestamp when the limit resets (midnight UTC)
X-Tier	Your current plan tier

Binance Spot and Binance Futures endpoints are available on Pro and Enterprise plans only, and are tracked against the same plan rate limits as the rest of the API.

Feature access by plan

Feature	Starter (Free)	Pro	Enterprise
Polymarket BTC markets	Limited recent markets	Included	Included
Polymarket ETH and SOL markets	—	Included	Included
Binance Spot APIs	—	Included	Included
Binance Futures APIs	—	Included	Included
Backtest AI Agent BETA	—	Free beta, 5 strategy generations/month	Included

Backtest AI Agent BETA quota

Backtest AI Agent BETA is tier-gated separately from the standard data API rate limits:

Plan	Backtest AI Agent quota
Starter (Free)	Not included
Pro	Free beta, 5 strategy generations/month
Enterprise	Included

Calls to POST /v1/backtest-ai/generate and POST /v1/backtest-ai/strategy consume the monthly Backtest AI Agent quota. Running an already-generated strategy with POST /v1/backtest-ai/run does not generate a new strategy.

Handling 429 responses

When you exceed the rate limit, the API returns a 429 Too Many Requests status with a Retry-After header.

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily request limit exceeded. Upgrade your plan for higher limits."
  }
}

Best practices

Respect the Retry-After header

The Retry-After header tells you how many seconds to wait before retrying. Implement exponential backoff.

Cache responses

Market data doesn’t change between snapshots. Cache responses for the snapshot interval (e.g., 5 minutes for 5m markets).

Use pagination wisely

Fetch only the data you need. Use limit and offset to paginate through large result sets.

Monitor your usage

Check your usage in the Dashboard or read the rate limit headers.

Need higher limits?

Upgrade to Pro for 50x more daily requests, or contact us for custom Enterprise limits.