API requests are rate-limited to ensure fair usage across all accounts. Current limits are returned in response headers on every request.
| Header | Description |
|---|
X-RateLimit-Limit | Maximum requests allowed per window |
X-RateLimit-Remaining | Remaining requests in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Exceeding the limit
If you exceed the rate limit, the API returns a 429 Too Many Requests response:
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Retry after 1709654400."
}
}
X-RateLimit-Reset header.
Implement exponential backoff in your client to handle rate limits gracefully. The Tusky SDK handles this automatically.
