finlight Logo

Thursday, July 16, 2026

Tickers y bolsas bien hechos con la API de finlight

Kevin Bartsch
TutorialGuide

Tickers y bolsas bien hechos con la API de finlight

Filtrar noticias por ticker suena sencillo hasta que choca con la realidad: el mismo ticker puede significar empresas distintas en bolsas distintas, y una misma empresa puede cotizar bajo varios tickers por todo el mundo. Si te equivocas, tu feed de "Apple" se llena en silencio de historias equivocadas.

finlight resuelve esto convirtiendo cada empresa etiquetada en identificadores reales y sin ambigüedad. Esta guía muestra cómo filtrar por ticker y cómo leer esos identificadores para que siempre apuntes a la empresa correcta.

Filtrar por ticker

La forma más rápida es el filtro estructurado tickers:

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

Fíjate en includeEntities: true. Eso le indica a finlight que devuelva los datos resueltos de la empresa para cada artículo, que es lo que te permite verificar que has acertado con la empresa correcta.

Leer las entidades resueltas

Con includeEntities activado, cada artículo lleva un arreglo companies. Una sola empresa tiene este aspecto:

{
  "companyId": 320,
  "name": "Apple Inc.",
  "ticker": "AAPL",
  "confidence": "0.98",
  "isin": "US0378331005",
  "openfigi": "BBG000B9XRY4",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "primaryListing": {
    "ticker": "AAPL",
    "exchangeCode": "NASDAQ",
    "exchangeCountry": "US"
  },
  "otherListings": [
    { "ticker": "APC", "exchangeCode": "XETRA", "exchangeCountry": "DE" }
  ]
}

Unos pocos campos hacen el trabajo pesado:

  • primaryListing es la cotización principal de la empresa, con su exchangeCode y exchangeCountry.
  • otherListings contiene todas las cotizaciones secundarias. Así ves que Apple también cotiza como APC en XETRA, en Alemania.
  • isin y openfigi son identificadores únicos a nivel global. A diferencia de un ticker simple, apuntan a exactamente un valor, lo que los hace ideales para cruzar con tus propios datos.
  • confidence te dice qué tan seguro está finlight de que el artículo trata realmente de esta empresa.

Desambiguar con precisión

Cuando un ticker simple es ambiguo, acótalo con el lenguaje de consulta. Puedes filtrar por la bolsa o por un identificador único:

ticker:AAPL AND exchange:NASDAQ

isin:US0378331005

Filtrar por isin u openfigi elimina la ambigüedad por completo, porque cada uno se resuelve a un único valor sin importar bajo cuántos tickers cotice la empresa.

Un patrón práctico

Para trabajar con carteras o listas de seguimiento, cruza por el identificador en el que más confíes:

  1. Si solo tienes tickers, envía tickers y activa includeEntities, luego confirma que primaryListing coincide con la bolsa que esperas.
  2. Si tienes ISIN u OpenFIGI, filtra con isin: / openfigi: en la consulta para una coincidencia exacta.
  3. Guarda el companyId de finlight junto a tus registros para que las búsquedas futuras no tengan ambigüedad.

A dónde ir después

Obtén tu clave de API gratuita →

Back to blog