Skip to main content
La cuota depende de tu plan. Una petición = 1 unidad, sea cual sea el número de filas devueltas. El contador se reinicia al inicio de cada hora (UTC).

​
Acceso por plan

Algunos endpoints están reservados a los planes superiores: Llamar a un endpoint fuera de tu plan devuelve 403:
403

​
Cabeceras de cuota

Cada respuesta autenticada incluye:

​
Exceso (429)

Agotada la cuota, las peticiones devuelven 429 hasta el reinicio:
429
La cabecera Retry-After indica los segundos hasta el reinicio (inicio de la hora siguiente, UTC).

​
Caudal instantáneo: 50 solicitudes / segundo

Además de la cuota horaria, cada clave está limitada a 50 solicitudes por segundo. Este límite protege la disponibilidad del servicio: sin él, un solo cliente podría consumir su cuota horaria en segundos y saturar la API para todos. Por encima de ese límite, la respuesta es 429 — sin consumir cuota:
429
La cabecera Retry-After vale 1: el contador se reinicia al segundo siguiente, a diferencia de la cuota horaria que espera al inicio de la hora. En la práctica, distribuya sus llamadas en lugar de enviar ráfagas — 50 solicitudes por segundo bastan de sobra para alimentar un modelo en tiempo real.

​
Una sola conexión WebSocket por clave

El flujo WebSocket (/ws, plan Sharp) acepta una conexión simultánea por clave API. Cada socket recibe todo el flujo: varias conexiones con la misma clave multiplican el ancho de banda sin aportar nada. Una segunda conexión se rechaza con el código de cierre 4409:
Se rechaza la conexión nueva, nunca la existente: un flujo ya establecido no se cortará en favor de un duplicado — normalmente un script reiniciado sin cerrar el anterior. Si su cliente se desconectó bruscamente, la plaza se libera al cerrarse el socket en el servidor, y reconectar de inmediato funciona. ¿Necesita varios flujos en paralelo? Cree una clave por proceso desde su área de cliente.

​
Sigue tu consumo

Tu consumo de la hora en curso también se muestra en tu área de cliente.