Comece a usar a API da brapi.dev
A brapi.dev é uma API REST para dados financeiros brasileiros. Você acessa ações, FIIs, BDRs, ETFs, índices, criptomoedas, câmbio e indicadores econômicos em JSON, com dados de fontes como CVM, IBGE e Banco Central do Brasil.
O objetivo da brapi é ser o jeito mais simples de levar esses dados para produtos, planilhas, dashboards, robôs, assistentes de IA e sistemas internos.
Primeira requisição
Você pode testar agora com 4 ações brasileiras populares, sem token ou cadastro:
Teste sem token
PETR4 (Petrobras) • MGLU3 (Magazine Luiza) • VALE3 (Vale) • ITUB4 (Itaú)
curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3,MGLU3"curl "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1mo&interval=1d"
curl "https://brapi.dev/api/v2/stocks/dividends?symbols=ITUB4"Essas ações de teste permitem consultar cotação, histórico, dividendos e dados financeiros para experimentar a API antes de criar uma conta.
Teste primeiro, autentique depois
PETR4, MGLU3, VALE3 e ITUB4 funcionam sem token para você testar a API. Para acessar todos os ativos e usar em produção, crie sua conta e gere um token no dashboard.
Onde encontrar seu token?
Seu token estará disponível na seção "Chaves de API" do seu Dashboard após o login.
Use o token no backend
Em produção, envie o token no header Authorization:
curl --request GET \
--url 'https://brapi.dev/api/v2/stocks/quote?symbols=PETR4' \
--header 'Authorization: Bearer SEU_TOKEN'Leia a resposta
A resposta vem em JSON, com um item em results para cada ticker solicitado.
{
"results": [
{
"requestedSymbol": "PETR4",
"symbol": "PETR4",
"changed": false,
"data": {
"shortName": "PETROBRAS PN",
"longName": "Petróleo Brasileiro S.A. - Petrobras",
"currency": "BRL",
"regularMarketPrice": 38.50,
"regularMarketDayHigh": 39.00,
"regularMarketDayLow": 38.20,
"regularMarketChange": 0.30,
"regularMarketChangePercent": 0.78,
"regularMarketTime": "2026-06-14T17:08:00.000Z",
"marketCap": 503100000000,
"regularMarketVolume": 45678901,
"logourl": "https://icons.brapi.dev/icons/PETR4.svg"
}
}
],
"requestedAt": "2026-06-14T17:08:02.000Z",
"took": 245
}Encontre o Dado Certo
Use esta tabela para ir direto ao endpoint do dado que você precisa.
| Preciso de | Endpoint | Documentação | Dados principais |
|---|---|---|---|
| Buscar e validar tickers B3 | /api/v2/tickers | Tickers disponíveis | Símbolo, nome, tipo, setor e filtros para autocomplete ou screener |
| Cotação atual | /api/v2/stocks/quote?symbols=PETR4,VALE3 | Cotação de ações | Preço, variação, volume, market cap, faixa do dia, faixa de 52 semanas e logo |
| Histórico de preços | /api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d | Histórico de ações | Série OHLCV, volume e preço ajustado |
| Dividendos e JCP | /api/v2/stocks/dividends?symbols=ITUB4 | Dividendos de ações | Dividendos, JCP, bonificações e subscrições de ações |
| Perfil da empresa | /api/v2/stocks/profile?symbols=PETR4 | Perfil de ações | CNPJ, setor, indústria, endereço, site, descrição e logo |
| Múltiplos e estatísticas | /api/v2/stocks/statistics?symbols=WEGE3&mode=current | Estatísticas de ações | P/L, P/VP, beta, dividend yield, EPS, market cap e séries históricas |
| Dados financeiros | /api/v2/stocks/financial-data?symbols=WEGE3&mode=current | Dados financeiros | Receita, lucro, EBITDA, margens, dívida e fluxo de caixa livre |
| Balanço patrimonial | /api/v2/stocks/balance-sheet?symbols=PETR4&period=annual | Balanço patrimonial | Ativos, passivos, patrimônio líquido, caixa e dívida |
| DRE | /api/v2/stocks/income-statement?symbols=PETR4&period=annual | DRE de ações | Receita, custos, lucro bruto, despesas, EBITDA e lucro líquido |
| Fluxo de caixa | /api/v2/stocks/cash-flow?symbols=PETR4&period=annual | Fluxo de caixa | Caixa operacional, investimento, financiamento e caixa livre |
| DVA | /api/v2/stocks/value-added?symbols=PETR4&period=annual | Valor adicionado | Demonstração de valor adicionado anual ou trimestral |
| Rendimentos de FIIs | /api/v2/fii/dividends?symbols=MXRF11 | FIIs | Rendimentos, histórico, relatórios, imóveis e carteira de fundos imobiliários |
Autenticação
Use o header Authorization em código backend e produção. Ele evita expor o
token em URLs, logs e histórico de navegação.
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4&token=SEU_TOKEN"O parâmetro ?token= funciona para ferramentas que não suportam headers
(Google Sheets, Excel Power Query, Notion). Tokens na URL podem aparecer em
histórico do navegador, logs de servidor e ferramentas de analytics.
Prefira header auth sempre que possível.
Atenção
Nunca exponha seu token no código do lado do cliente. Em aplicações web, faça as chamadas para a API da brapi.dev a partir do seu backend.
Principais Conceitos
- URL base: todas as requisições usam
https://brapi.dev/api. - Símbolos: endpoints de mercado usam
symbols=PETR4,VALE3para consultar um ou mais ativos na mesma chamada. - Resposta: endpoints por ativo retornam
results[]; o payload principal fica emresults[].data. - Datas: use
startDateeendDateno formatoYYYY-MM-DDquando quiser controlar a janela de consulta. - Períodos contábeis: fundamentos aceitam
period=annualouperiod=quarterly; alguns endpoints também aceitammode=currentoumode=history.
Explore Nossos Endpoints
Navegue pelas seções para acessar todos os dados disponíveis.
Cotação de Ações
Preço atual, variação, volume, market cap e logo de tickers B3.
Histórico de Ações
Séries OHLCV com range, intervalo ou datas específicas.
Dividendos de Ações
Dividendos, JCP, bonificações e subscrições de ações.
Fundamentos
Perfil, estatísticas, dados financeiros e demonstrações contábeis.
Tickers
Busque, filtre, valide e resolva símbolos de instrumentos B3.
FIIs
Indicadores, histórico, relatórios, imóveis, carteira e rendimentos.
Criptomoedas
Cotações e informações das principais criptomoedas do mercado.
Moedas (Câmbio)
Taxas de câmbio atualizadas e histórico PTAX.
Macroeconomia
SELIC, CDI, IPCA, IGP-M, TR, IBC-Br, PIB mensal, desemprego e mais.
Servidor MCP para IAs
Use dados financeiros brasileiros em assistentes de IA compatíveis com MCP.
SDKs Oficiais
Use nossas bibliotecas oficiais quando quiser integração com tipos, helpers e tratamento de erros pronto.
TypeScript / JavaScript
SDK oficial com suporte a Node.js e navegador.
Python
SDK oficial Python com suporte síncrono e assíncrono.
Exemplos Práticos
Veja como buscar os mesmos dados em diferentes ambientes.
curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3"
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d"
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/v2/stocks/income-statement?symbols=PETR4&period=annual"import requests
token = "SEU_TOKEN"
response = requests.get(
"https://brapi.dev/api/v2/stocks/quote",
headers={"Authorization": f"Bearer {token}"},
params={"symbols": "PETR4,VALE3"},
)
response.raise_for_status()
data = response.json()
for item in data["results"]:
quote = item["data"]
print(item["symbol"], quote["regularMarketPrice"])const response = await fetch(
'https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3',
{
headers: {
Authorization: `Bearer ${process.env.BRAPI_API_TOKEN}`,
},
},
);
if (!response.ok) {
throw new Error(`Erro HTTP ${response.status}`);
}
const data = await response.json();
for (const item of data.results) {
console.log(item.symbol, item.data.regularMarketPrice);
}Próximos Passos
- Consulte cotações de ações: comece com preço atual, variação e volume.
- Monte seu fluxo com tickers: busque símbolos, valide entradas e descubra cobertura por endpoint.
- Veja todos os exemplos: aplique a API em planilhas, backends, sites e integrações.