Rate Limits & Errors
Understand rate limits, response headers, and error codes.
Rate Limits by Plan
| Plan | Daily Limit | Per Second |
|---|
| Free | 1,000 | 5 |
| Trader | 50,000 | 20 |
| Business | 500,000 | 50 |
Response Headers
Every API response includes rate limit headers so you can track your usage.
X-RateLimit-LimitMaximum requests allowed in the current window.
X-RateLimit-RemainingRequests remaining in the current window.
X-RateLimit-ResetUnix timestamp when the rate limit window resets.
Best Practices
- •Cache responses — Card data and prices don't change every second. Cache for at least 5 minutes.
- •Use batch lookups — Fetch up to 20 cards per request using the
ids parameter instead of individual calls. - •Implement exponential backoff — When you hit a 429, wait and retry with increasing delays (1s, 2s, 4s).
- •Monitor rate limit headers — Check
X-RateLimit-Remaining to proactively slow down before hitting limits.