2 min read
Definition
A token bucket holds up to a burst number of tokens and refills continuously at a sustained rate. Each request spends one token; when the bucket is empty you are throttled until it refills. Because refill is continuous, you can spend a burst then settle to the sustained rate.
In plain terms
A rate limiter that lets you spike briefly but caps your steady pace.
Why it matters here
The partner ring meters per project this way (build 10 req/s, launch 25, scale 100). See rate limiting explained.
Related reading

Project
A project is the partner unit that owns an OAuth client and a rate-limit bucket. Sandbox and live are…
Read →
RateLimit-* headers
The RateLimit- headers — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — appear on every response so…
Read →
Idempotency key
An idempotency key is a header you attach to a mutating request so a retry returns the original result…
Read →Funding for UK limited companies
Credicorp lends to your company, not to you personally — short-term working capital with no personal guarantee. See what your business could access.