Límites de tasa y errores
Entiende los límites de tasa, headers de respuesta y códigos de error.
Límites de tasa por plan
| Plan | Límite diario | Por segundo |
|---|
| Gratis | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
Headers de respuesta
Cada respuesta de la API incluye headers de límite de tasa para que puedas rastrear tu uso.
X-RateLimit-LimitSolicitudes maximas permitidas en la ventana actual.
X-RateLimit-RemainingSolicitudes restantes en la ventana actual.
Mejores prácticas
- •Cachear respuestas — Los datos y precios de cartas no cambian cada segundo. Cachea por al menos 5 minutos.
- •Usar consultas por lotes — Obtén hasta 20 cartas por solicitud usando el parámetro
ids en lugar de llamadas individuales. - •Implementar backoff exponencial — Cuando recibas un 429, espera y reintenta con delays crecientes (1s, 2s, 4s).
- •Monitorear headers de límite de tasa — Verifica
X-RateLimit-Remaining para reducir proactivamente la velocidad antes de alcanzar los límites.