Rate Limits

Rate limits are applied per API key using a sliding window.

Limit	Value
Requests	120 / minute

Quote endpoints

The spot quote endpoints are metered in a separate budget, because they reach the same live router OceanX’s own order flow quotes against:

Limit	Value
Quote requests	300 / minute

Spending one budget does not touch the other. Within it:

Endpoint	Cost
`GET /spot/quote`	1 per request
`POST /spot/exit-check`	1 per ladder rung — a 5-rung ladder costs 5
`GET /spot/quote/stream`	1 per tick

Response headers

Every response includes the current rate-limit state:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1751385600      # unix seconds when the window resets

Handling 429s

When a request exceeds the limit, the API returns 429 Too Many Requests with a Retry-After header:

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{ "error": { "code": "rate_limited", "message": "Rate limit exceeded." } }

Back off for at least the number of seconds in Retry-After before retrying. For sustained polling, watch X-RateLimit-Remaining and pace requests to stay within the window.

Start Here

Trading

Markets

Research

Social

Rewards

Developer API

Integrations

Reference

Quote endpoints

Response headers

Handling 429s

​Quote endpoints

​Response headers

​Handling 429s

Quote endpoints

Response headers

Handling 429s