Rate Limits

Our API ensures stability using a Token Bucket algorithm.
This allows for short bursts of traffic while maintaining a steady sustained rate.

How it works:
- Bucket Capacity (Burst): You have a maximum allowance of 100 tokens.
- Refill Rate: The bucket refills at a rate of 10 tokens per second.

Request Cost:
- Standard requests: 1 token
- Resource-intensive requests: 5 tokens

Response Headers

Every API response includes headers to help you monitor your current usage context:

X-Ratelimit-Limit: Your total capacity and refill rate (e.g., burst:100;rate:10).
‍X-Ratelimit-Remaining: The number of tokens currently available in your bucket.
‍X-Ratelimit-Cost: The token cost of the request you just made.
‍X-Ratelimit-ResetTime: (in seconds) until the bucket is fully refilled.

Exceeding the Limit

‍If your request exceeds the available tokens, the API returns a 429 Too Many Requests status.
Please retry the request after the duration specified in the headers.