Skip to content
KiukiPlatform
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-After says, then send the same request again.

Need more? Tell Kiuki what you are building.