Límites de tasa y cuotas

Cada clave de API de finlight está vinculada a un plan, y el plan define tus límites de uso y a qué capacidades puedes acceder. Los límites se aplican por clave de API, en tiempo real. Esta página explica cada límite y lo que desbloquea cada plan; para los números exactos de tu plan, consulta el panel de finlight o la página de precios.

Los cuatro límites de uso

Name
Cuota mensual de solicitudes
Description
Cada solicitud REST consume una solicitud de tu asignación mensual. El contador se reinicia al comienzo de cada período de facturación. Superarlo devuelve 429 con "Exceeded token limit of N for the current period."
Name
Tasa de ráfaga
Description
Un límite a corto plazo sobre las solicitudes por cada 10 segundos, que suaviza los picos. Solo se aplica en los planes que lo definen. Superarlo devuelve 429 con "Exceeded rate limit of N requests per 10 seconds." — espera ~10 s y reintenta.
Name
Conexiones WebSocket
Description
El número máximo de conexiones WebSocket concurrentes para tu clave. Las nuevas conexiones que superen el límite se rechazan. Un límite aparte restringe el número total de mensajes transmitidos por período. WebSocket requiere un plan de pago.
Name
Cuota de entrega de webhooks
Description
El número máximo de entregas de webhook por período de facturación. Un límite complementario restringe cuántos webhooks puedes crear. Cuando se agota la cuota de entrega, las entregas se pausan hasta el siguiente período.

Capacidades que desbloquea tu plan

Más allá de los límites en bruto, tu plan controla qué funciones están disponibles. Solicitar una función que tu plan no incluye devuelve 403 (para REST) o simplemente omite los datos (para webhooks/WebSocket).

Name
Datos históricos
Description
Hasta qué punto puedes consultar hacia atrás depende de tu plan. Los planes Free y Pro Light cubren actualmente aproximadamente el último mes de artículos; los planes superiores desbloquean una cobertura histórica más profunda. Usa los filtros de fecha from / to para consultar dentro de la ventana de tu plan; las solicitudes de fechas fuera de ella simplemente no devuelven resultados para ese rango. Consulta la página de precios para conocer la ventana histórica exacta de cada plan.
Name
Análisis de sentimiento
Description
Incluye los campos sentiment y confidence en los artículos. Se eliminan de las cargas cuando no se concede.
Name
Entidades de empresa
Description
Incluye el array companies (tickers resueltos por IA, ISIN, bolsa, etc.) y habilita includeEntities. Se elimina cuando no se concede.
Name
Fuentes personalizadas
Description
Fuentes de noticias privadas o específicas del cliente añadidas a tu conjunto predeterminado. Disponible en planes superiores / enterprise.

Cómo funciona la aplicación de límites

Por clave, en tiempo real. Cada solicitud incrementa tus contadores; una vez que se cruza un límite, la API devuelve 429 de inmediato.
El uso del panel no es en vivo. El uso que se muestra en el panel de finlight se agrega aproximadamente una vez al día y refleja la actividad hasta el día anterior; no es un contador en tiempo real. La aplicación es en vivo, así que tu cuota restante real para hoy puede diferir de lo que muestra el panel.
Los contadores mensuales se reinician al comienzo de tu período de facturación; un 429 de cuota se borra automáticamente.
Sin encabezados de límite de tasa. finlight no envía actualmente encabezados Retry-After ni X-RateLimit-*. Trata un 429 de ráfaga como "espera ~10 segundos"; trata un 429 mensual como "cuota alcanzada para este período". Consulta Errores y códigos de estado.

Planes

Plan	Uso típico
Free	Evaluación y uso de bajo volumen. Solo REST (sin WebSocket).
Pro (Light / Standard / Scale)	Cargas de trabajo de producción con cuotas crecientes, WebSocket, webhooks y enriquecimiento más completo.
Enterprise	Alto volumen, fuentes personalizadas y límites a medida.

Los límites numéricos exactos (tokens mensuales, tasa de ráfaga, conexiones WebSocket, cuota de webhooks) y el conjunto de funciones por plan forman parte de los precios y pueden cambiar. Consulta siempre los límites de tu plan actual en el panel de finlight, o compara planes en la página de precios. ¿Necesitas límites más altos o fuentes personalizadas? Contáctanos.

Cuando alcanzas un límite

429 de ráfaga → pausa ~10 segundos y luego continúa.
429 de cuota mensual → has usado las solicitudes de tu período; mejora el plan o espera al reinicio.
Conexión WebSocket rechazada → estás en tu tope de conexiones concurrentes; cierra una conexión inactiva (consulta la opción takeover en Inicio rápido de WebSocket).
Entregas de webhook pausadas → tu cuota de entrega del período está agotada; se reanuda en el siguiente período.
403 en una función → esa capacidad no está en tu plan; consulta la tabla anterior.

Para los cuerpos de error exactos, consulta Errores y códigos de estado.