Rate limits
Requests are rate-limited per account on a rolling 1-minute window. The table below shows the default limits per endpoint group. Some endpoints enforce a stricter limit — check each endpoint’s description for its specific value.
| Scope | Default limit | Window |
|---|---|---|
Write (POST /ingest/*) per account |
600 requests | 1 minute rolling |
Orders endpoints (GET /orders*) per account |
150 requests | 1 minute rolling |
Requests endpoints (GET /requests*) per account |
150 requests | 1 minute rolling |
Returns endpoints (GET /returns*) per account |
120 requests | 1 minute rolling |
Webhook subscriptions (/webhook_subscriptions*) per account |
60 requests | 1 minute rolling |
Exceeding any limit returns 429 Too Many Requests. Use the response headers
to determine when to retry:
| Header | Description | Example |
|---|---|---|
X-RateLimit-Limit |
Maximum requests allowed in the window | 600 |
X-RateLimit-Remaining |
Requests remaining (0 when rate-limited) |
0 |
X-RateLimit-Reset |
Unix timestamp when the window resets | 1710345600 |
Retry-After |
Seconds to wait before retrying | 60 |