Rate limits

Requests are rate limited per access token. Every response tells you how much of your budget remains, and a request over the limit returns 429.

Headers

Each response carries your current budget:

Header	Meaning
`X-RateLimit-Limit`	Requests allowed per minute.
`X-RateLimit-Remaining`	Requests left in the current window.
`Retry-After`	Seconds to wait, present on a `429`.

When you hit the limit

A throttled request returns 429 Too Many Requests with the standard error body:

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests. Slow down and retry.",
    "request_id": "req_…"
  }
}

Back off and retry. Wait for the Retry-After interval, then retry. Build exponential backoff into your client so a burst smooths out instead of hammering the limit.

Was this page helpful?

Pagination

Wallet