[ blog · comparison ]9 min read

API de fundamentos de empresas: balanço patrimonial, fluxo de caixa e negociações de insiders para agentes financeiros

Sarah ChoyPublicado em 16 de junho de 20269 min de leitura

Os preços dizem o que o mercado pensa; os fundamentos dizem se ele está certo. Aqui está uma API de fundamentos moldada para agentes de IA — demonstrações financeiras, dividendos e negociações de insiders em um único endpoint — e como ela se compara ao SEC EDGAR bruto e aos provedores de API de demonstrações.

TL;DR

•Fundamentos = a camada do 'o negócio está realmente saudável?': balanço patrimonial, demonstração de resultados, fluxo de caixa, dividendos, transações de insiders.
•Você pode fazer o parsing de graça a partir do SEC EDGAR (XBRL), mas normalizar XBRL entre diferentes filers e períodos é engenharia real e contínua — e é só dos EUA e no ritmo dos filings, não moldado para consultas.
•O Financials Search da API Pick retorna os cinco fundamentos de empresas dos EUA atrás de um único endpoint POST — 200 créditos/chamada, só-se-acertar — pré-moldados para o raciocínio de um LLM.
•As transações de insiders (Form 4) e o histórico de dividendos são os sinais subutilizados: baratos de puxar aqui, dolorosos de montar a partir do EDGAR.
•Combine Financials com SEC Filings (texto qualitativo de 10-K/10-Q) e Markets (preço) para uma visão ancorada completa.

Preço é opinião; fundamentos são evidência

Uma chamada de dados de mercado diz ao seu agente quanto uma ação custa. Ela não consegue dizer se o negócio por trás está crescendo, se afogando em dívidas ou sendo silenciosamente vendido pelos próprios executivos. Essa é a camada de fundamentos — e é onde um agente de pesquisa passa de "cita preços" para "forma uma opinião".

Cinco datasets carregam a maior parte do sinal: o balanço patrimonial, a demonstração de resultados, a demonstração de fluxo de caixa, o histórico de dividendos e as transações de insiders.

O imposto do EDGAR

Tudo isso é público e gratuito no SEC EDGAR. O problema é o XBRL. O JSON de company-facts é enorme e inconsistente: o mesmo conceito é marcado de forma diferente entre filers, as reapresentações turvam o histórico e você precisa mapear uma taxonomia espalhada para um schema limpo antes que qualquer coisa downstream possa usá-la. Os dados de insiders (Form 4) e os dividendos são tipos de filing separados que você faz o parsing por conta própria. Fazer isso uma vez para um ticker é um fim de semana; fazer isso de forma confiável para um agente que consulta qualquer empresa é um pipeline mantido.

Fundamentos como uma única ferramenta

Financials Search retorna balanços patrimoniais, demonstrações de resultados, fluxo de caixa, dividendos e transações de insiders de empresas de capital aberto dos EUA atrás de um único endpoint POST — 200 créditos por chamada, só-se-acertar, pré-moldados para um LLM.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. provedor vs. suíte

	Fazer parsing do SEC EDGAR	Provedor de API de demonstrações	API Pick Financials
Custo	Grátis + engenharia	Assinatura	200 créditos/chamada, só se acertar
Configuração	Pipeline de normalização de XBRL	Integrar endpoints tipados	Um endpoint, uma forma
Cobertura	EUA, organizado por filing	Profunda, histórico longo	Fundamentos dos EUA + insiders + dividendos
Estilo de consulta	Por filing/conceito	Parâmetros tipados	Linguagem natural
Melhor para	Pontual / controle total	Fundamentos como o produto	Agentes financeiros (uma ferramenta de muitas)

A foto completa

Os fundamentos se combinam naturalmente com SEC Filings Search para o lado qualitativo (fatores de risco, MD&A, linguagem das earnings calls) e com Markets Search para o preço. Juntos, eles são a espinha dorsal do agente de pesquisa de investimentos. Uma chave, JSON do começo ao fim, só-se-acertar. Comece de graça com 100 créditos, sem cartão.

Perguntas Frequentes

Não dá para eu simplesmente obter os fundamentos de graça no SEC EDGAR?

Dá — os dados de company-facts e XBRL do EDGAR são gratuitos e oficiais. O custo é a engenharia: as tags XBRL variam entre filers e períodos, as reapresentações complicam o histórico e você precisa mapear milhares de conceitos da taxonomia para um schema limpo antes que um modelo (ou um gráfico) possa usá-los. Além disso, é só dos EUA e organizado por filing, não por pergunta. Para uma empresa de vez em quando, o EDGAR está ótimo. Para um agente que consulta muitas empresas em linguagem natural, uma API normalizada economiza semanas.

O que está coberto — e é só dos EUA?

Balanços patrimoniais, demonstrações de resultados, demonstrações de fluxo de caixa, histórico de dividendos e transações de insiders de empresas de capital aberto listadas nos EUA. São fundamentos dos EUA; para emissores fora dos EUA você usaria uma fonte diferente. Para o texto do filing em si (fatores de risco do 10-K, MD&A do 10-Q, earnings calls), use o endpoint separado SEC Filings Search.

Por que vale a pena destacar as transações de insiders e os dividendos?

São de alto sinal e chatos de montar por conta própria. A compra/venda de insiders (Form 4 da SEC) é um sinal comportamental muito observado; o histórico de dividendos importa para os screens de renda e de qualidade. Ambos exigem o parsing de tipos de filing específicos do EDGAR. Aqui eles são campos de primeira classe no mesmo endpoint das demonstrações financeiras.

Como isso se compara aos provedores de API de demonstrações financeiras?

Provedores dedicados (por exemplo, as APIs de demonstrações financeiras) entregam endpoints profundos e tipados e histórico longo — ótimos se os fundamentos são todo o seu produto. O ângulo da API Pick é diferente: os fundamentos como mais uma ferramenta dentro de uma suíte (mercados, SEC, econômicos, notícias) atrás de uma única chave, moldados para consultas de um agente, cobrados só-se-acertar. Se você está construindo um agente financeiro em vez de um produto de fundamentos, a suíte-em-uma-só-forma é o caminho mais rápido.

Isso é recomendação de investimento?

Não. São dados financeiros públicos estruturados para pesquisa e ancoragem de agentes. Informa a análise de uma pessoa qualificada ou de um agente supervisionado; não é recomendação e não deve impulsionar trading automatizado sem responsabilidade humana e controles de risco.