Qué puede hacer la API de finlight

finlight es una API de noticias financieras. Toma el flujo constante y desordenado de noticias de los mercados globales y lo convierte en datos limpios, estructurados y enriquecidos con IA que puedes consultar, recibir en streaming o hacer que te los envíen. En lugar de rastrear sitios web y analizar HTML por tu cuenta, obtienes una interfaz consistente con sentimiento, etiquetado de empresas y filtrado avanzado integrados.

Esta página es el mapa. Cubre lo que finlight te ofrece, las cuatro formas de consumirlo y a dónde ir después. Si solo quieres hacer tu primera llamada, empieza por la guía de inicio rápido.

Qué incluye cada artículo

Cada artículo que devuelve finlight está estructurado y enriquecido, no es solo un titular y un enlace. Obtienes:

• Campos principales: título, resumen, contenido completo (opcional), fuente, fecha de publicación, idioma e imágenes.
• Sentimiento: cada artículo se puntúa como positive, neutral o negative con un valor de confianza, para que puedas cuantificar el tono en lugar de leer cada noticia.
• Entidades de empresa: finlight etiqueta las empresas a las que se refiere una noticia y las resuelve a identificadores reales: ticker, ISIN, OpenFIGI, sector e industria, además de cada bolsa en la que cotiza la empresa (cotizaciones primarias y secundarias, cada una con su código de bolsa y país).
• Clasificación: cada artículo se etiqueta con los países a los que afecta y con una o más de 13 categorías.

Esto significa que puedes responder preguntas como "¿cómo cambió el sentimiento sobre AAPL esta semana?" o "muéstrame todas las noticias regulatorias que afectan a un conjunto de empresas" sin construir tú mismo un pipeline de NLP.

Cuatro formas de obtener los datos

Los mismos datos enriquecidos están disponibles a través de cuatro métodos de entrega. Elige el que encaje con tu carga de trabajo.

REST API

Consulta noticias bajo demanda: envías una solicitud y recibes una página de artículos coincidentes. Ideal para búsquedas, rellenos históricos, paneles programados y cualquier flujo de solicitud/respuesta. El endpoint avanzado POST /v2/articles admite el conjunto completo de filtros, y también hay endpoints para obtener un solo artículo por URL y para listar las fuentes disponibles. Consulta la documentación de REST.

WebSocket

Recibe artículos en streaming en tiempo real a medida que se publican, sin sondeo. Viene en dos variantes: un flujo mejorado con enriquecimiento completo (sentimiento y entidades) y un flujo en crudo ligero para cuando solo necesitas lo básico de forma rápida. Ideal para paneles en vivo, señales de trading y monitorización. Consulta la documentación de WebSocket.

Webhooks

Haz que finlight envíe noticias a tu propio endpoint en el momento en que coincidan con tus filtros. Hay variantes enriquecida y en crudo disponibles, y las entregas van firmadas para que puedas verificarlas. Ideal para pipelines basados en eventos, alertas y automatizaciones que deben ejecutarse sin que tengas que sondear. Consulta la documentación de webhooks.

Servidor MCP

Conecta finlight a un asistente de IA como Claude o ChatGPT a través del Model Context Protocol y luego pídele noticias de los mercados en lenguaje natural. Ideal para investigación y análisis puntuales sin escribir código. Consulta la documentación de asistentes de IA.

Como regla general: REST para bajo demanda, WebSocket para tiempo real, webhooks para automatización por envío y MCP para investigación impulsada por IA. Una guía comparativa específica está próximamente.

Filtrado preciso

finlight está diseñado en torno a obtener exactamente las noticias que quieres. En REST, WebSocket y webhooks puedes filtrar por:

• Tickers: empresas como AAPL o NVDA.
• Países: códigos de país ISO, para centrarte en mercados concretos.
• Categorías: cualquiera de las 13, desde markets y economy hasta crypto, regulation y energy.
• Fuentes: incluye o excluye medios concretos, o añade otros adicionales.
• Rangos de fechas y un lenguaje de consulta completo con operadores booleanos y filtros por campo, por ejemplo (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com.

Para la sintaxis completa de consulta, consulta la documentación de consultas avanzadas.

Cobertura global y multilingüe

finlight cubre noticias en 9 idiomas: inglés, chino simplificado, hindi, español, japonés, coreano, portugués, árabe y ruso. Combinado con los filtros de país y categoría, eso te permite seguir un mercado en su propio idioma y región en lugar de depender de una cobertura solo en inglés.

Hecho para desarrolladores

Puedes llamar a finlight con HTTP puro o usar los SDK oficiales:

• Node / TypeScript: npm install finlight-client
• Python: pip install finlight-client

Ambos envuelven las API REST y WebSocket, gestionan la autenticación y los reintentos, y devuelven objetos tipados. La autenticación es una única cabecera X-API-KEY en cada solicitud, usando una clave que generas en el panel de control. Una solicitud mínima tiene este aspecto:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tickers": ["AAPL"], "pageSize": 5 }'

Planes

finlight tiene planes que van desde un nivel gratuito para pruebas hasta enterprise, y se diferencian principalmente en volumen de solicitudes, profundidad del historial, acceso en tiempo real y funciones como las fuentes personalizadas. El plan gratuito es solo REST e ideal para evaluar. Para ver los límites actuales y lo que desbloquea cada nivel, consulta finlight.me/pricing.

Empieza a construir

• ¿Es tu primera vez? Sigue la guía de inicio rápido para hacer tu primera llamada en cinco minutos.
• ¿Listo para profundizar? Explora la documentación completa.
• ¿Tienes preguntas? Únete al Discord o escribe a info@finlight.me.

Consigue tu clave de API gratuita →