O que a API da finlight faz

A finlight é uma API de notícias financeiras. Ela pega o fluxo constante e caótico de notícias dos mercados globais e o transforma em dados limpos, estruturados e enriquecidos por IA que você pode consultar, transmitir ou receber por push. Em vez de fazer scraping de sites e analisar HTML por conta própria, você tem uma única interface consistente com sentimento, marcação de empresas e filtragem rica já embutidos.

Esta página é o mapa. Ela cobre o que a finlight oferece, as quatro formas de consumi-la e para onde ir em seguida. Se você só quer fazer sua primeira chamada, comece pelo guia de Primeiros passos.

O que vem em cada artigo

Cada artigo que a finlight retorna é estruturado e enriquecido, não apenas uma manchete e um link. Você recebe:

• Campos principais: título, resumo, conteúdo completo (opcional), fonte, data de publicação, idioma e imagens.
• Sentimento: cada artigo recebe a pontuação positive, neutral ou negative com um valor de confiança, para que você possa quantificar o tom em vez de ler cada notícia.
• Entidades de empresa: a finlight marca as empresas mencionadas em uma notícia e as resolve para identificadores reais: ticker, ISIN, OpenFIGI, setor e indústria, além de cada bolsa em que a empresa está listada (listagens primárias e secundárias, cada uma com código da bolsa e país).
• Classificação: cada artigo é marcado com os países que afeta e uma ou mais das 13 categorias.

Isso significa que você pode responder perguntas como "como o sentimento sobre a AAPL mudou esta semana?" ou "mostre-me todas as notícias de regulação que afetam um conjunto de empresas" sem construir um pipeline de NLP por conta própria.

Quatro formas de obter os dados

Os mesmos dados enriquecidos estão disponíveis por meio de quatro métodos de entrega. Você escolhe o que se encaixa na sua carga de trabalho.

REST API

Consulte notícias sob demanda: envie uma requisição, receba de volta uma página de artigos correspondentes. Melhor para busca, backfills, painéis agendados e qualquer fluxo de requisição/resposta. O endpoint avançado POST /v2/articles suporta o conjunto completo de filtros, e há também endpoints para buscar um único artigo por URL e para listar as fontes disponíveis. Veja a documentação REST.

WebSocket

Receba artigos em tempo real assim que são publicados, sem polling. Vem em dois formatos: um fluxo aprimorado com enriquecimento completo (sentimento e entidades) e um fluxo bruto leve para quando você só precisa do básico rapidamente. Ideal para painéis ao vivo, sinais de trading e monitoramento. Veja a documentação do WebSocket.

Webhooks

Tenha a finlight enviando notícias para o seu próprio endpoint no momento em que correspondem aos seus filtros. Há variantes enriquecida e bruta, e as entregas são assinadas para que você possa verificá-las. Melhor para pipelines orientados a eventos, alertas e automações que devem rodar sem que você faça polling. Veja a documentação de webhooks.

Servidor MCP

Conecte a finlight a um assistente de IA como Claude ou ChatGPT por meio do Model Context Protocol e peça notícias do mercado em linguagem natural. Melhor para pesquisa e análise pontual sem escrever código. Veja a documentação de assistentes de IA.

Como regra geral: REST para sob demanda, WebSocket para ao vivo, webhooks para automação por push e MCP para pesquisa orientada por IA. Um guia de comparação dedicado está chegando em breve.

Filtragem precisa

A finlight foi construída em torno de obter exatamente as notícias que você quer. Em REST, WebSocket e webhooks você pode filtrar por:

• Tickers: empresas como AAPL ou NVDA.
• Países: códigos de país ISO, para focar em mercados específicos.
• Categorias: qualquer uma das 13, de markets e economy a crypto, regulation e energy.
• Fontes: inclua ou exclua veículos específicos, ou opte por adicionar outros.
• Intervalos de datas e uma linguagem de consulta completa com operadores booleanos e filtros de campo, por exemplo (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com.

Para a sintaxe completa de consulta, veja a documentação de consultas avançadas.

Cobertura global e multilíngue

A finlight cobre notícias em 9 idiomas: inglês, chinês simplificado, hindi, espanhol, japonês, coreano, português, árabe e russo. Combinado com filtros de país e categoria, isso permite que você acompanhe um mercado em seu próprio idioma e região, em vez de depender de uma cobertura apenas em inglês.

Feito para desenvolvedores

Você pode chamar a finlight com HTTP puro ou usar os SDKs oficiais:

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

Ambos encapsulam as APIs REST e WebSocket, cuidam de autenticação e novas tentativas e retornam objetos tipados. A autenticação é um único cabeçalho X-API-KEY em cada requisição, usando uma chave que você gera no painel. Uma requisição mínima é assim:

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

Planos

A finlight tem planos que vão de um nível gratuito para testes até enterprise, diferindo principalmente em volume de requisições, profundidade do histórico, acesso em tempo real e recursos como fontes personalizadas. O plano gratuito é somente REST e ideal para avaliação. Para os limites atuais e o que cada nível desbloqueia, veja finlight.me/pricing.

Comece a construir

• Novo por aqui? Siga o guia de Primeiros passos para fazer sua primeira chamada em cinco minutos.
• Pronto para se aprofundar? Navegue pela documentação completa.
• Dúvidas? Entre no Discord ou envie um e-mail para info@finlight.me.

Obtenha sua chave de API gratuita →