Plan access
Some endpoints are reserved for higher plans:
Calling an endpoint outside your plan returns
403:
403
Quota headers
Every authenticated response carries:Over quota (429)
Once the quota is exhausted, requests return429 until the reset:
429
Retry-After header gives the number of seconds until the reset (top of the next hour, UTC).
Burst limit: 50 requests / second
On top of the hourly quota, each key is capped at 50 requests per second. This limit protects service availability: without it, a single client could burn its hourly quota in seconds and saturate the API for everyone. Beyond that, the response is429 — without consuming quota:
429
Retry-After header is 1: the counter resets on the next second, unlike the hourly quota which waits for the top of the hour. In practice, spread your calls rather than sending bursts — 50 requests per second is far more than enough to feed a real-time model.
One WebSocket connection per key
The WebSocket feed (/ws, Sharp plan) accepts one simultaneous connection per API key. Every socket receives the full feed: multiple connections on the same key multiply bandwidth without adding anything.
A second connection is refused with close code 4409: