Appearance
Rate Limiting
General Limits
The VALR API enforces two rate limits simultaneously:
- Per API key: 2000 calls per minute
- Per IP address: 1200 calls per minute
If either limit is exceeded, the API returns 429 Too Many Requests with the header x-valr-ratelimited: true.
Reset Behaviour
The rate limit counter resets at the start of each minute.
Example 1: If 2000 API calls are made between 12:00:00 and 12:00:30, additional calls will be rejected until 12:01:00.
Example 2: If 1500 API calls are made between 12:00:00 and 12:00:59, a further 2000 calls can be made starting at 12:01:00.
Per-Second Rate Limits
High-frequency trading routes have additional per-second rate limits:
| Route | Method | Rate Limit |
|---|---|---|
/v1/public/* | GET | 30/m |
/v1/public/time | GET | 20/s |
/v1/public/status | GET | 20/s |
/v1/public/*/buckets | GET | 20/s |
/v1/batch/orders | POST | 400/s |
/v1/orders | DELETE | 450/s |
/v1/orders | POST | 400/s |
/v2/orders/modify | PUT | 400/s |
/v1/loans/* | POST, PUT, DELETE | 1/s |
/v1/account/subaccount | POST | 1/s |
/v1/account/subaccount/transfer | POST | 20/s |
WebSocket Rate Limits
New connections: The /ws endpoint allows a maximum of 60 new client connections per minute.
Write operations on /ws/account:
| Operation | Rate Limit |
|---|---|
| Place order | 400/s |
| Cancel order | 450/s |
| Batch orders | 400/s |
| Modify order | 400/s |
⚠️ WARNING
We may reduce limits when the system is under severe pressure.