Rate Limits & Errors
Understand rate limits, response headers, and error codes.
Rate Limits by Plan
| Plan | Daily Limit | Burst Limit |
|---|
| Free | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
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.
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.