Rate Limiting

We use a Token bucket to implement our rate limiting functionality. There is a limit of 50 requests per second. Once you hit this limit, you get a 429 response for all subsequent requests until the next second.

Managing ratelimits

Every API endpoint returns a set of HTTP headers that denotes your current limits.

❯ curl -i "https://api.fluidcoins.com/v1/currencies"
HTTP/2 200
date: Sun, 25 Sep 2022 01:38:06 GMT
content-type: application/json; charset=utf-8
ratelimit-limit: 50
ratelimit-remaining: 49
ratelimit-reset: 1
vary: Origin
x-rate-limit-duration: 1
x-rate-limit-limit: 50.00
  • x-rate-limit-limit : maximum number of requests you're permitted to make per second.
  • ratelimit-remaining: Number of requests remaining in the current rate limit window.
  • ratelimit-reset: Rate limit reset timer ( 1s )

Depending on your previous usage and other heuristics, you might get up to 200 requests per second but this is not promised and you should try to stay within the 50 rps window