API Reference
Rate Limits
Understand OneRouter's rate limiting system, quotas, and how to handle limit errors gracefully in your applications.
Rate Limit Headers
Every API response includes rate limit headers:
| Header | Description |
|---|---|
x-ratelimit-limit-requests | Max requests per minute |
x-ratelimit-remaining-requests | Remaining requests in current window |
x-ratelimit-limit-tokens | Max tokens per minute |
x-ratelimit-remaining-tokens | Remaining tokens in current window |
x-ratelimit-reset-requests | Seconds until request quota resets |
Default Limits
| Tier | RPM | TPM |
|---|---|---|
| Free | 60 | 100,000 |
| Pay-as-you-go | 500 | 1,000,000 |
| Enterprise | Custom | Custom |
When you exceed a limit, the API returns 429 Too Many Requests. Implement exponential backoff with jitter for production resilience.