API de dados da B3: alternativas e como escolher em 2026

A comparação usa documentação pública consultada em maio de 2026. Preços citados refletem páginas oficiais e podem mudar. A intenção não é eleger uma vencedora universal: cada API resolve um problema ligeiramente diferente.

O cenário das APIs de B3 em 2026

O ecossistema brasileiro amadureceu nos últimos cinco anos. Antes, scraping de Fundamentus, StatusInvest ou da própria B3 era a regra. Hoje há pelo menos sete opções viáveis para consumir dados da B3 via API REST. As categorias se organizam assim:

• Agregadoras freemium: brapi, bolsai e HG Brasil. APIs REST que consolidam dados de B3, CVM e BCB com plano gratuito e tiers pagos acessíveis.
• Oficiais B3 e enterprise: UP2DATA da B3 e Market Data Cloud da Cedro Technologies. Distribuidoras com SLA, contrato e foco em pessoas jurídicas.
• Especialistas em opções: OpLab, focada em mercado de opções com greeks, volatilidade implícita e séries listadas.
• Fontes públicas alternativas: yfinance (Yahoo Finance via biblioteca Python) e arquivos COTAHIST da própria B3. Gratuitas, mas com limitações conhecidas.

Cada categoria atende um perfil diferente. Antes de comparar nomes, vale entender os critérios decisivos.

Cinco critérios para escolher uma API B3

1. Cobertura de dados: ações, FIIs, fundamentos calculados, dividendos, opções, criptomoedas, BDRs e macro. Nem toda API entrega tudo. Listar o que o projeto exige antes de escolher evita o segundo cadastro daqui a três meses.
2. Preço por requisição útil: não o preço bruto do plano, mas o custo de cada chamada que entrega o dado necessário. Uma API que exige três chamadas para o que outra faz em uma costuma sair mais cara.
3. Latência: cotação com 15 minutos de delay serve para backtest e dashboard pessoal; não serve para day-trade. Fundamentos atualizados na publicação do ITR servem para análise; não para algotrading em earnings.
4. Qualidade e metodologia: indicadores fundamentalistas são opiniões metodológicas. Saber como o EBIT foi calculado, se o lucro usa conta CVM 3.11 ou 3.05 e como o provedor trata bancos importa para reprodutibilidade.
5. DX: documentação, exemplos Python e cURL, autenticação simples, formato previsível. Tempo de integração compõe o custo total da decisão.

APIs agregadoras freemium

A categoria mais popular entre desenvolvedores independentes, estudantes e pequenas fintechs. As três opções cobrem 90% dos casos comuns e têm plano gratuito sem cartão.

APIs oficiais e enterprise

Para projetos que exigem SLA contratual, tempo real ou redistribuição comercial, as freemium não bastam. Duas opções dominam o mercado brasileiro.

Especialistas e fontes alternativas

Vale também citar os arquivos COTAHIST da própria B3: largura fixa 245 bytes por linha, Latin-1, histórico desde 1986. Fonte primária sem intermediário, mas exigem parsing manual e não cobrem fundamentos. Para regulatório original, os relatórios DFP, ITR e dados CVM também são públicos no Sistema CVM, com o mesmo trade-off de parsing custoso. O post sobre dados históricos da B3 explica o formato COTAHIST em detalhes.

Comparativo de cobertura

A tabela abaixo resume o que cada API oferece em termos de tipos de dado disponíveis hoje. As respostas refletem documentação pública em maio de 2026.

A leitura prática: nenhuma API cobre tudo. brapi cobre amplo e raso, bolsai cobre profundo em fundamentos, Cedro cobre tempo real e profissional, yfinance cobre o básico para protótipo. Combinar duas costuma resolver mais do que escolher a "melhor" sozinha.

Comparativo de preços e limites

Preço isolado nunca é a métrica certa, mas é o filtro inicial. A tabela compara o plano gratuito e o plano pago inicial de cada provedor.

Os planos pagos das agregadoras (brapi Startup, bolsai Pro, HG Brasil) ficam todos numa faixa acessível para uso pessoal e pequenas empresas. As enterprise (UP2DATA, Cedro) saltam para a faixa profissional, com SLA, suporte dedicado e justificativa contratual para dados redistribuídos. Para a maioria dos projetos individuais ou de pequena escala, as duas pontas do espectro nem competem entre si.

Como escolher: árvore de decisão por caso de uso

A pergunta correta não é "qual a melhor", mas "qual atende este caso". As cinco situações abaixo cobrem a maioria dos projetos que aparecem em fóruns de desenvolvedores brasileiros.

1. Dashboard pessoal de carteira

Cotação diária, dividendos, fundamentos básicos. Dezenas de requisições por dia, delay de 15 minutos aceitável. bolsai sozinha resolve: 200 req/dia gratuitos e 27 indicadores eliminam cálculos manuais. brapi gratuita é equivalente quando o foco é apenas cotação.

2. Backtest de estratégia quantitativa

Histórico de preços ajustados, fundamentos com TTM, séries macro (CDI). Dezenas de milhares de requisições no setup, ad-hoc depois. bolsai Pro (R$49/mês): 10.000 req/dia e endpoints /stocks/{ticker}/history, /fundamentals/{ticker}/history e /macro/series/{indicator} cobrem o que um backtest em Python precisa, e o screener consolidado simplifica universos de teste (veja como construir um screener em Python).

3. Aplicativo ou fintech em produção

Cotação consolidada, fundamentos para tela de detalhe, dividendos, FIIs. Dezenas de milhares de usuários, delay aceitável na v1. Arquitetura híbrida: agregadora freemium para home (cotação) e bolsai para detalhe (fundamentos, dividendos, FIIs). Quando tempo real virar requisito, Cedro Market Data entra como camada adicional.

4. Robô de análise com IA

Tudo que o modelo de linguagem precise em runtime, volume imprevisível, delay aceitável. bolsai com MCP: o servidor MCP oficial permite que Claude, Cursor e Zed invoquem endpoints diretamente, sem glue code. O agente IA com Claude e MCP mostra a configuração em 5 minutos. Para Custom GPTs no ChatGPT via OAuth2, há um tutorial dedicado ao ChatGPT na bolsa brasileira.

5. Mesa proprietária ou estratégia intraday

Livro de ofertas, times and trades, opções com greeks, latência em milissegundos. Cedro Market Data Cloud para tempo real e OpLab para opções. UP2DATA entra quando há exigência regulatória de fonte primária. Freemium não atende esse perfil.

Combinando APIs: o padrão híbrido

Muitos projetos reais usam duas ou três APIs em conjunto. A arquitetura híbrida preserva os limites gratuitos de cada provedor e tira proveito da especialização de cada um. O exemplo abaixo combina bolsai (fundamentos) e brapi (cotação) num único cliente Python.

import httpx
import os

# Credenciais em variáveis de ambiente
BOLSAI_KEY = os.environ["BOLSAI_API_KEY"]
BRAPI_TOKEN = os.environ["BRAPI_TOKEN"]

# Cotação intraday via brapi (gratuito, volume alto)
def get_quote(ticker):
    r = httpx.get(
        f"https://brapi.dev/api/quote/{ticker}",
        params={"token": BRAPI_TOKEN},
    )
    return r.json()["results"][0]["regularMarketPrice"]

# Fundamentos calculados via bolsai (27 indicadores, TTM)
def get_fundamentals(ticker):
    r = httpx.get(
        f"https://api.usebolsai.com/api/v1/fundamentals/{ticker}",
        headers={"X-API-Key": BOLSAI_KEY},
    )
    return r.json()

# Uso combinado: tela de detalhe de ação
ticker = "ITUB4"
preco = get_quote(ticker)
fund = get_fundamentals(ticker)

print(f"{ticker}: R${preco:.2f}")
print(f"  P/L:  {fund['pl']}")
print(f"  P/VP: {fund['pvp']}")
print(f"  ROE:  {fund['roe']}%")

# ITUB4: R$33.42
#   P/L:  9.99
#   P/VP: 2.13
#   ROE:  21.32%

A separação funciona porque cada API responde em formato previsível e os custos não se sobrepõem. get_quote consome o gratuito da brapi, get_fundamentals consome o gratuito da bolsai. Quando cotação é alta frequência e fundamentos baixa, o "orçamento efetivo" gratuito multiplica. O guia bolsai vs brapi aprofunda a arquitetura híbrida.

Critério prático de decisão

Três perguntas costumam resolver a escolha em menos de cinco minutos:

1. Precisa de tempo real e SLA? Se sim, vá direto para Cedro ou UP2DATA. Se não, descarte enterprise.
2. Precisa de fundamentos profundos (TTM, histórico longo, screener)? Se sim, bolsai. Se não, brapi e HG Brasil cobrem com plano gratuito generoso.
3. Envolve agente de IA (Claude, Cursor, GPTs)? Se sim, a integração MCP nativa da bolsai elimina glue code. Se não, qualquer REST resolve.

Quando as respostas combinam (fundamentos profundos mais cotação em volume), a arquitetura híbrida mantém o custo total zero ou próximo de zero. Planos pagos entram quando os limites gratuitos ficam apertados ou SLA vira requisito formal.

Perguntas frequentes

Qual a melhor API de dados da B3 em 2026?

Não existe uma resposta única. Para cotações em volume com baixo custo, brapi e HG Brasil cobrem bem. Para análise fundamentalista com 27 indicadores calculados e MCP para IA, bolsai foi desenhada com esse caso em mente. Para dados oficiais com SLA contratual, UP2DATA da B3 e Market Data Cloud da Cedro são as opções enterprise. A decisão correta começa por mapear os endpoints exigidos pelo projeto e o orçamento mensal disponível.

Existe API oficial gratuita da B3?

A B3 mantém UP2DATA como plataforma oficial de distribuição de dados, mas o serviço é pago e contratado apenas por pessoas jurídicas. Para pessoa física, a B3 publica arquivos COTAHIST de domínio público com preços diários históricos, sem suporte e em formato de largura fixa que exige parsing manual. APIs REST gratuitas como brapi, bolsai e HG Brasil agregam dados oficiais da B3 e CVM e os entregam em JSON limpo.

yfinance funciona bem com ações brasileiras?

Funciona com limitações. Tickers brasileiros precisam do sufixo .SA (PETR4.SA, VALE3.SA), o histórico de preços vem completo, mas indicadores fundamentalistas costumam estar atrasados ou ausentes, dividendos nem sempre refletem JCP corretamente e o serviço pode mudar a política de rate limit sem aviso. Para protótipos pessoais funciona; para produção, qualquer API REST com SLA é preferível.

Quanto custa uma API B3 confiável em 2026?

A faixa varia bastante. Planos pagos básicos de APIs agregadoras começam em R$49 por mês (bolsai Pro) ou faixa equivalente em brapi Startup e HG Brasil. APIs enterprise como Market Data Cloud da Cedro entram em outra ordem de grandeza, normalmente entre centenas e milhares de reais por mês, com SLA e dados em tempo real. UP2DATA da B3 tem preço sob consulta e contratação corporativa.

Posso combinar duas APIs B3 no mesmo projeto?

Sim, e é um padrão arquitetural comum. Uma combinação frequente usa brapi ou HG Brasil para cotação em alta frequência (limites gratuitos amplos) e bolsai para análise fundamentalista e dividendos pré-calculados. Cada API retorna JSON e pode coexistir no mesmo cliente HTTP. O ganho é preservar os tetos gratuitos de cada provedor e usar cada uma na dimensão em que é mais forte.

Leia também

Referências

• brapi.dev: site oficial e documentação da brapi.
• hgbrasil.com/finance: documentação da HG Brasil Finance API.
• b3.com.br/up2data: página oficial da UP2DATA da B3.
• marketdatacloud.com.br: APIs de Market Data Cloud da Cedro Technologies.
• oplab.com.br: plataforma OpLab para mercado de opções.
• Documentação da bolsai: endpoints, parâmetros, exemplos e limites.

Conteúdo educativo e técnico, sem caráter de recomendação de investimento ou contratação de serviço. Planos, limites e preços citados refletem informações públicas dos provedores em maio de 2026 e podem mudar. Consulte a documentação oficial de cada API antes de tomar decisões de arquitetura ou contratar planos pagos. As menções a empresas de terceiros são baseadas em material público e não constituem endosso comercial.