Getting started

Rate limits

Limits are enforced per consumer at the gateway. WebSocket connections count against a separate concurrency budget.

Per-tier limits

  • x402 (anonymous): 30 requests / minute per IP.
  • Dev: 60 requests / minute.
  • Builder: 600 requests / minute.
  • Commercial: 3000 requests / minute.
  • Contract: custom.

See Access tiers for the full surface matrix.

Response headers

Every response carries your current budget:

http
RateLimit-Limit: 600
RateLimit-Remaining: 583
RateLimit-Reset: 41

Handling 429

Over the limit returns 429 Too Many Requests with a Retry-After header (seconds). Back off and retry — prefer exponential backoff with jitter.

Prefer streams over polling

If you're polling recent on a tight loop, switch to the live WebSocket for that family (Builder+). One connection replaces hundreds of requests and stays under budget.