Rate Limits

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

Limit	Value
Requests	120 / minute

Market Overview, Market Movement and Discovery Analytics each cost one request from this standard REST budget. They share native cached producer observations.

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