Rate Limits
Request weight, limits and how to stay within them.
SPACEDEX limits how much you can request in a window so the platform stays fast for everyone. Limits apply per IP address and per API key, and most are measured in weight rather than raw request count.
Weight
Each endpoint has a weight: a cheap endpoint costs 1, a heavy one costs more. A large order book snapshot, for example, costs more than a single ticker. Every page in this reference lists the weight for its endpoints.
| Limit | Window | Value |
|---|---|---|
| Request weight (per IP) | 1 minute | 1,200 |
| Orders (per API key) | 10 seconds | 100 |
| Orders (per API key) | 24 hours | 200,000 |
Reading your usage
Every response includes headers showing how much of the current window you have used. Watch them and back off before you hit the ceiling.
| Header | Meaning |
|---|---|
| X-SDX-Used-Weight-1m | Weight consumed in the current 1-minute window |
| X-SDX-Order-Count-10s | Orders placed in the current 10-second window |
| Retry-After | Seconds to wait, sent with a 429 or 418 response |
When you exceed a limit
Going over returns HTTP 429 (Too Many Requests) with a Retry-After header. If you keep sending requests after a 429, SPACEDEX may return HTTP 418 and temporarily block your IP, with escalating durations for repeat offenders.