Thursday, July 16, 2026

Tickers e Bolsas do Jeito Certo com a API da finlight

Kevin Bartsch

Tickers e Bolsas do Jeito Certo com a API da finlight

Filtrar notícias por ticker parece simples até você bater na realidade: o mesmo ticker pode representar empresas diferentes em bolsas diferentes, e uma única empresa pode ser negociada sob vários tickers pelo mundo. Erre nisso e seu feed da "Apple" silenciosamente se enche das matérias erradas.

A finlight resolve isso ao mapear cada empresa marcada para identificadores reais e inequívocos. Este guia mostra como filtrar por ticker e como ler esses identificadores para que você sempre acerte a empresa certa.

Filtrando por ticker

A maneira mais rápida é o filtro estruturado 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
  }'

Note o includeEntities: true. Ele diz à finlight para retornar os dados resolvidos da empresa em cada artigo, que é o que permite verificar se você correspondeu à empresa certa.

Lendo as entidades resolvidas

Com includeEntities ativado, cada artigo carrega um array companies. Uma única empresa tem este formato:

{
  "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" }
  ]
}

Alguns campos fazem o trabalho pesado:

primaryListing é a listagem principal da empresa, com seu exchangeCode e exchangeCountry.
otherListings contém todas as listagens secundárias. É assim que você vê que a Apple também é negociada como APC na XETRA, na Alemanha.
isin e openfigi são identificadores globalmente únicos. Diferentemente de um ticker isolado, eles apontam para exatamente um título, o que os torna ideais para casar com seus próprios dados.
confidence indica o quanto a finlight está segura de que o artigo é realmente sobre essa empresa.

Desfazendo ambiguidades com precisão

Quando um ticker simples é ambíguo, estreite-o com a linguagem de consulta. Você pode filtrar pela bolsa ou por um identificador único:

ticker:AAPL AND exchange:NASDAQ

isin:US0378331005

Filtrar por isin ou openfigi elimina a ambiguidade por completo, porque cada um resolve para um único título, independentemente de quantos tickers a empresa negocie.

Um padrão prático

Para trabalho com carteira ou watchlist, faça a correspondência pelo identificador em que você mais confia:

Se você só tem tickers, envie tickers e ative includeEntities, depois confirme que o primaryListing corresponde à bolsa que você espera.
Se você tem ISINs ou ids OpenFIGI, filtre com isin: / openfigi: na consulta para uma correspondência exata.
Armazene o companyId da finlight junto aos seus registros para que buscas futuras sejam inequívocas.

Para onde ir agora

Obtenha sua chave de API gratuita →

Back to blog

Thursday, July 16, 2026

Tickers e Bolsas do Jeito Certo com a API da finlight