Primeros pasos con la API de noticias financieras de finlight

Las noticias financieras en tiempo real son un caos. Decenas de fuentes, formatos distintos, sin estructura y sin señal. finlight convierte ese torrente de información en datos limpios, estructurados y enriquecidos con IA que puedes consultar en una sola solicitud, con análisis de sentimiento y las empresas a las que se refiere cada noticia incluidos.

Esta guía te lleva de cero a tu primera llamada a la API en unos cinco minutos. Al terminar habrás obtenido las últimas noticias de una acción, sabrás leer la respuesta y habrás visto cómo activar un flujo en tiempo real.

Qué obtienes

finlight es una API de noticias financieras con cuatro formas de consumir los mismos datos enriquecidos:

• REST. Consulta noticias bajo demanda (esta guía).
• WebSocket. Recibe artículos en streaming en tiempo real a medida que se publican.
• Webhooks. Haz que las noticias se envíen a tu propio endpoint.
• Servidor MCP. Deja que un asistente de IA (Claude, ChatGPT) consulte las noticias por ti.

Cada artículo se devuelve estructurado y enriquecido con:

• Sentimiento (positive, neutral o negative) más una puntuación de confianza.
• Entidades de empresa: tickers, ISIN, cotizaciones en bolsa, sector e industria.
• Cobertura en 9 idiomas y 13 categorías (mercados, economía, cripto, tecnología y más).

Paso 1: Obtén tu clave de API

1. Crea una cuenta gratuita en app.finlight.me.
2. Abre el panel de control y genera una clave de API.
3. Guárdala en un lugar seguro. La enviarás en cada solicitud en la cabecera X-API-KEY.

El plan gratuito es solo REST y perfecto para hacer pruebas. Consulta finlight.me/pricing para ver los límites actuales y lo que desbloquea cada plan.

Paso 2: Instala el cliente (opcional)

Puedes llamar a la API con HTTP puro, pero los SDK oficiales se encargan de la autenticación, los reintentos y los tipos por ti.

# TypeScript / Node.js
npm install finlight-client

# Python
pip install finlight-client

¿Prefieres HTTP en crudo? Sáltate este paso. Todos los ejemplos siguientes también muestran cURL.

Paso 3: Tu primera solicitud

Vamos a obtener los últimos artículos sobre Apple (AAPL). Esto llama a POST /v2/articles con un filtro tickers.

# cURL
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
  }'

// TypeScript
import { FinlightApi } from 'finlight-client';

const client = new FinlightApi({ apiKey: 'YOUR_API_KEY' });

const response = await client.articles.fetchArticles({
  tickers: ['AAPL'],
  pageSize: 5,
});

console.log(`Got ${response.articles.length} articles`);
for (const article of response.articles) {
  console.log(article.publishDate, article.sentiment, article.title);
}

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

response = client.articles.fetch_articles(
    GetArticlesParams(tickers=["AAPL"], pageSize=5)
)

print(f"Got {len(response.articles)} articles")
for article in response.articles:
    print(article.publishDate, article.sentiment, article.title)

Paso 4: Lee la respuesta

La respuesta es un sobre paginado. Cada artículo incluye su fuente, titular, resumen y enriquecimiento:

{
  "status": "ok",
  "page": 1,
  "pageSize": 5,
  "articles": [
    {
      "link": "https://www.example.com/apple-earnings",
      "title": "Apple beats expectations on services revenue",
      "summary": "Apple reported quarterly results above analyst estimates...",
      "source": "www.example.com",
      "publishDate": "2026-06-18T14:32:00.000Z",
      "language": "en",
      "sentiment": "positive",
      "confidence": "0.93",
      "images": ["https://www.example.com/img/apple.jpg"]
    }
  ]
}

Dos opciones te permiten pedir más cuando lo necesitas:

• includeContent: true devuelve el texto completo del artículo extraído, no solo el resumen.
• includeEntities: true devuelve el array companies (tickers, ISIN, cotizaciones en bolsa) de cada artículo.

Consejo: mantén includeContent e includeEntities desactivados para vistas de lista ligeras, y actívalos solo cuando necesites el detalle. Así las respuestas siguen siendo pequeñas y rápidas.

Paso 5: Pásate al tiempo real (cuando estés listo)

El sondeo está bien para empezar, pero para paneles en vivo y señales de trading querrás que las noticias se envíen en el momento en que se publican. Eso es el WebSocket: los mismos filtros, sin sondeo.

// TypeScript
import { FinlightApi } from 'finlight-client';

const client = new FinlightApi({ apiKey: 'YOUR_API_KEY' });

client.websocket.connect({ tickers: ['AAPL'] }, (article) => {
  console.log('New article:', article.sentiment, article.title);
});

El streaming por WebSocket está disponible en los planes de pago. Consulta la documentación de WebSocket para la configuración completa.

Próximos pasos

Ya has hecho tu primera llamada y has visto la forma de los datos. A partir de aquí:

• Lee la documentación completa de la API para conocer los endpoints, los parámetros y las guías de WebSocket y webhooks.
• Aprende el filtrado avanzado. Combina tickers, países, categorías y un lenguaje de consulta para obtener exactamente las noticias que quieres (artículo próximamente).
• Compara los planes cuando estés listo para ir más allá del plan gratuito.

¿Tienes preguntas? Únete al Discord o escribe a info@finlight.me.

Empieza a construir gratis →