HG Brasil e brapi.dev são duas APIs brasileiras para dados financeiros. Neste comparativo técnico, analisamos qual oferece melhor experiência para desenvolvedores que precisam de dados de ações, fundos e indicadores econômicos.
Resumo Executivo
| Critério | brapi.dev | HG Brasil |
|---|---|---|
| Dados de Ações | ✅ Completos | ⚠️ Básicos |
| Fundamentalistas | ✅ BP, DRE, DFC, DVA | ❌ Não disponível |
| Dividendos | ✅ Histórico completo | ❌ Não disponível |
| FIIs e BDRs | ✅ Completo | ⚠️ Limitado |
| Moedas | ✅ | ✅ |
| Indicadores | ✅ IPCA, SELIC | ✅ CDI, SELIC |
| Plano Gratuito | 15.000 req/mês | 1.000 req/mês |
| Documentação | ✅ Extensa | ✅ Boa |
Veredito Rápido: Para dados de ações e fundamentos, brapi.dev oferece cobertura muito mais completa. HG Brasil foca em cotações básicas e câmbio.
Comparativo de Funcionalidades
1. Dados de Ações
brapi.dev - Cobertura Completa:
import requests
url = "https://brapi.dev/api/quote/PETR4"
params = {
"modules": "defaultKeyStatistics,financialData,balanceSheetHistory",
"token": "SEU_TOKEN"
}
response = requests.get(url, params=params)
dados = response.json()['results'][0]
# Cotação + Fundamentalistas + Indicadores
print(f"Preço: R$ {dados['regularMarketPrice']}")
print(f"P/L: {dados['defaultKeyStatistics']['trailingPE']}")
print(f"ROE: {dados['defaultKeyStatistics']['returnOnEquity']}")HG Brasil - Dados Básicos:
import requests
# Apenas cotação básica
url = "https://api.hgbrasil.com/finance/stock_price"
params = {
"key": "SUA_CHAVE",
"symbol": "PETR4"
}
response = requests.get(url, params=params)
dados = response.json()
# Apenas preço e variação
# Sem dados fundamentalistas
# Sem indicadores financeiros2. Dados Fundamentalistas
| Módulo | brapi.dev | HG Brasil |
|---|---|---|
| Balanço Patrimonial | ✅ Desde 2009 | ❌ |
| DRE (Resultados) | ✅ Trimestral/Anual | ❌ |
| Fluxo de Caixa | ✅ Completo | ❌ |
| DVA | ✅ Completo | ❌ |
| Indicadores (P/L, ROE) | ✅ | ❌ |
| Estatísticas-Chave | ✅ | ❌ |
brapi.dev - Análise Fundamentalista Completa:
# Obtenha todos os demonstrativos financeiros
params = {
"modules": "balanceSheetHistory,incomeStatementHistory,cashflowStatementHistory",
"token": "SEU_TOKEN"
}
response = requests.get("https://brapi.dev/api/quote/ITUB4", params=params)
dados = response.json()['results'][0]
# Acesso a anos de histórico
balanco = dados['balanceSheetHistory']['balanceSheetHistory']
dre = dados['incomeStatementHistory']['incomeStatementHistory']
for periodo in dre[:4]: # Últimos 4 trimestres
print(f"{periodo['endDate']}: Lucro = R$ {periodo['netIncome']:,.0f}")3. Dividendos
brapi.dev:
- ✅ Histórico completo de dividendos e JCP
- ✅ Datas de declaração, ex e pagamento
- ✅ Dados desde 2009
HG Brasil:
- ❌ Dados de dividendos não disponíveis
# brapi.dev - Dividendos completos
params = {"dividends": "true", "token": "SEU_TOKEN"}
response = requests.get("https://brapi.dev/api/quote/BBAS3", params=params)
dados = response.json()['results'][0]
for div in dados['dividendsData']['cashDividends'][:5]:
print(f"{div['paymentDate']}: R$ {div['rate']} por ação")4. Dados Históricos
brapi.dev:
# Até 10+ anos de histórico
params = {
"range": "5y", # 5 anos
"interval": "1d", # Diário
"token": "SEU_TOKEN"
}
response = requests.get("https://brapi.dev/api/quote/VALE3", params=params)
historico = response.json()['results'][0]['historicalDataPrice']
print(f"Total de candles: {len(historico)}")HG Brasil:
- ⚠️ Histórico limitado
- ⚠️ Menos intervalos disponíveis
5. Câmbio e Moedas
Ambas as APIs oferecem dados de câmbio:
brapi.dev:
response = requests.get("https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL")
dados = response.json()
for moeda in dados['currency']:
print(f"{moeda['name']}: R$ {moeda['bid']}")HG Brasil:
response = requests.get("https://api.hgbrasil.com/finance?key=SUA_CHAVE")
dados = response.json()
usd = dados['results']['currencies']['USD']
print(f"Dólar: R$ {usd['buy']}")Preços e Limites
Comparativo de Planos
| Aspecto | brapi.dev Gratuito | HG Brasil Gratuito |
|---|---|---|
| Requisições/mês | 15.000 | 1.000 |
| Ações por requisição | 1 | 1 |
| Dados históricos | 3 meses | Limitado |
| Fundamentalistas | Básico | ❌ |
| Aspecto | brapi.dev Pro | HG Brasil Pro |
|---|---|---|
| Preço mensal | R$ 99,99 | Sob consulta |
| Requisições/mês | 500.000 | Varia |
| Fundamentalistas | ✅ Completo | ❌ |
| Dividendos | ✅ Completo | ❌ |
| Histórico | 10+ anos | Limitado |
Custo-Benefício
ANÁLISE DE CUSTO PARA DADOS COMPLETOS DE AÇÕES
brapi.dev Pro (R$ 99,99/mês):
✅ 500.000 requisições
✅ Dados fundamentalistas completos
✅ Histórico de dividendos
✅ 10+ anos de cotações
✅ Indicadores financeiros
HG Brasil:
✅ Cotações básicas
✅ Câmbio e indicadores
❌ Sem fundamentalistas
❌ Sem dividendos
❌ Histórico limitado
Para análise de ações → brapi.dev
Para apenas câmbio → Ambos funcionamQuando Usar Cada API
Escolha brapi.dev quando precisar de:
✅ Análise fundamentalista de ações ✅ Dados completos de dividendos ✅ Histórico longo de cotações (10+ anos) ✅ Indicadores financeiros (P/L, ROE, EV/EBITDA) ✅ Balanços e DREs trimestrais ✅ Dados de FIIs e BDRs ✅ Maior volume de requisições
Escolha HG Brasil quando precisar de:
✅ Apenas cotações básicas de ações ✅ Dados de câmbio ✅ Indicadores econômicos (CDI, SELIC) ✅ Projeto simples com baixo volume
Migração de HG Brasil para brapi.dev
Antes (HG Brasil):
import requests
def get_stock_hg(symbol, api_key):
url = "https://api.hgbrasil.com/finance/stock_price"
params = {"key": api_key, "symbol": symbol}
response = requests.get(url, params=params)
return response.json()Depois (brapi.dev):
import requests
def get_stock_brapi(symbol, token=''):
url = f"https://brapi.dev/api/quote/{symbol}"
if token:
url += f"?token={token}"
response = requests.get(url)
return response.json()
# Mesma simplicidade, mais dados disponíveis
dados = get_stock_brapi('PETR4')
# Agora você pode adicionar:
# - Fundamentalistas: modules=defaultKeyStatistics
# - Dividendos: dividends=true
# - Histórico: range=1y&interval=1dConclusão
| Se você precisa de... | Recomendação |
|---|---|
| Análise de ações BR | brapi.dev |
| Dados fundamentalistas | brapi.dev |
| Dividendos | brapi.dev |
| Apenas câmbio | Ambos |
| Maior volume grátis | brapi.dev (15x mais) |
| APIs complementares | Use ambas |
Próximos Passos
- Crie sua conta gratuita - 15.000 requisições/mês
- Explore a documentação - Guias completos
- Teste no Playground - Sem código
- Veja exemplos de integração - Python, JS, Excel
Compare você mesmo! Teste a brapi.dev gratuitamente e veja a diferença nos dados de ações brasileiras.
