Skip to main content

Rate Limiting

Data portal API is rate limited. It uses the Token Bucket algorithm for rate limiting with burst capacity of 50 tokens and refill rate of 1 token per second.

If you are unfamiliar with the token bucket concept, think of it like this:

  • Each API request costs 1 gold. Burst capacity is the size of your wallet. You can fit only 50 gold in your wallet, the amount you start with

  • Refill rate defines how much gold you earn. In this case, you earn 1 gold every second, until your wallet is full

  • If you spend faster than you earn, at some point you will have to stop and wait for some gold to appear in your wallet before sending further requests. But if you send one request per second or less, you will never run out of gold

The Authentication endpoints (/auth/login and /auth/refresh) on all our APIs have an additional rate limit of 1 request per 5 seconds. But this should not be a problem if you reuse auth tokens in your scripts.