Límites de tasa
Entiende cómo funciona la limitación de tasa, el acceso a datos según el plan y cómo gestionar las respuestas 429.
GET /api/v1/limits para consultar tu plan y tus límites actuales de forma programática.| Plan | Solicitudes / min | Ráfaga / s |
|---|---|---|
| Builder (incl. prueba gratuita de 3 días) | 250 | 12 |
| Pro | 750 | 40 |
| Enterprise | Personalizado | Personalizado |
El límite por minuto usa una ventana deslizante. La ráfaga usa un token bucket.
En el plan Builder (incluida la prueba gratuita de 3 días, que es Builder completo), el acceso se limita a los mercados más recientes. Los planes Pro y Enterprise tienen acceso ilimitado a todos los mercados y snapshots.
| Tipo de mercado | Builder | Pro / Enterprise |
|---|---|---|
| 5m | 4,100 | Ilimitado |
| 15m | 1,400 | Ilimitado |
| 1hr | 350 | Ilimitado |
| 4hr | 85 | Ilimitado |
| 24hr | 14 | Ilimitado |
Cuando una consulta de listado supera el máximo de tu plan, el límite de la respuesta se recorta y se incluye un campo warning.
El número de claves de API activas que puedes tener depende de tu plan. Las claves revocadas o caducadas no cuentan para el límite.
Cada respuesta incluye cabeceras de límite de tasa para que puedas seguir tu uso en tiempo real.
X-RateLimit-Limit: 250
X-RateLimit-Remaining: 237
X-RateLimit-Reset: 1740800060Gestión de las respuestas 429
Cuando superas tu límite de tasa, la API devuelve un código de estado 429 con una cabecera Retry-After que indica cuántos segundos debes esperar. El cuerpo de la respuesta incluye los campos error, message y retry_after.
import time
import requests
def fetch_with_retry(url, headers, max_retries=3):
for attempt in range(max_retries):
response = requests.get(url, headers=headers)
if response.status_code == 429:
wait = int(response.headers.get("Retry-After", 2 ** attempt))
time.sleep(wait)
continue
return response
raise Exception("Rate limit exceeded after retries")Si intentas acceder a un mercado o a sus snapshots fuera de la ventana de datos de tu plan, la API devuelve 403 Forbidden. Mejora tu plan o accede a un mercado más reciente.
{
"error": "Forbidden",
"message": "Your builder plan only includes the most recent markets for this type. Upgrade for full access.",
"tier": "builder"
}