Documentation
Rate Limits
Per-key request limits across all authenticated Scanna endpoints, and how 429 responses behave.
A single per-key cap applies across all authenticated endpoints — calls to
/hot, /predict, /signals, and everything else share one budget per minute
per key.
| Plan | Limit (global, per key) |
|---|---|
| Pro | Standard |
| Max | Custom |
| Enterprise | Unlimited |
| Flex (x402) | Protocol-limited |
Note
POST /heat carries an additional, stricter per-route cap on top of the global
limit — it's the most compute-heavy endpoint. GET /health is public and
unmetered.
Exceeding the limit
Exceeding the limit returns 429 with a Retry-After header indicating how
many seconds to wait before retrying:
HTTP/1.1 429 Too Many Requests
Retry-After: 12Back off for the indicated interval and retry. Need a higher ceiling? See Plans & Pricing.