Documentation
Rate limits
How fast a key may call.
Each key may send 20 requests a second on average, in bursts of up to 100. Sandbox and live keys are counted separately, each key on its own.
A request beyond that gets 429 Too Many Requests, with a Retry-After header saying how many seconds to wait, and nothing is done:
{"error": "rate_limited", "message": "Too many requests from this key: at most 20 a second on average, in bursts of up to 100. Send it again in 1 s (Retry-After)."}
Staying under it
- Page through the catalogue with
limit=200, and keep a copy: it changes slowly. - Don't ask about an order again and again: register a webhook endpoint and be told.
- When you get a 429, wait as long as
Retry-Aftersays, then send the same request again.
Need more? Tell Kiuki what you are building.