Esta seção cobre os dados de ativos listados na B3: ações, FIIs, BDRs, ETFs, units e índices com cobertura disponível, como o IBOVESPA.
A cobertura de índices é limitada e pode variar por símbolo. Consulte a verificação por ticker antes de pedir cotação ou histórico.
Para integrações novas, use os endpoints em /api/v2/stocks/*. Cada um traz um
tipo de dado e você pede só o que precisa.
| Você quer | Endpoint |
|---|---|
| Preço e variação de hoje | /api/v2/stocks/quote |
| Série de preços | /api/v2/stocks/historical |
| Dividendos e JCP | /api/v2/stocks/dividends |
| Dados cadastrais da empresa | /api/v2/stocks/profile |
| P/L, P/VP, dividend yield | /api/v2/stocks/statistics |
| Receita, EBITDA, margens | /api/v2/stocks/financial-data |
| Balanço, DRE, DFC, DVA | Demonstrações |
| Lista e busca de ativos | /api/quote/list |
O endpoint legado /api/quote/{tickers} continua funcionando e é documentado
abaixo. Ele devolve tudo em uma resposta só, controlada pelo parâmetro
modules. A resposta fica grande e mistura dados que mudam a cada minuto com
dados que mudam a cada trimestre. Se você está começando agora, prefira os
endpoints v2. Se você já usa o legado, veja o
guia de migração.
PETR4, MGLU3, VALE3 e ITUB4 respondem sem autenticação, com todos os recursos. Se você misturar um desses com qualquer outro ticker na mesma requisição, a chamada inteira passa a exigir token.
curl "https://brapi.dev/api/quote/PETR4,VALE3"O parâmetro modules aceita uma lista separada por vírgula. Cada módulo
corresponde hoje a um endpoint v2 dedicado.
| Módulo | Conteúdo | Equivalente v2 |
|---|---|---|
summaryProfile | Cadastro da empresa | /api/v2/stocks/profile |
defaultKeyStatistics | Múltiplos nos últimos 12 meses | /api/v2/stocks/statistics |
financialData | Receita, EBITDA e margens nos últimos 12 meses | /api/v2/stocks/financial-data |
balanceSheetHistory | Balanço anual | /api/v2/stocks/balance-sheet |
incomeStatementHistory | DRE anual | /api/v2/stocks/income-statement |
cashflowHistory | Fluxo de caixa anual | /api/v2/stocks/cash-flow |
valueAddedHistory | DVA anual | /api/v2/stocks/value-added |
Todo módulo de histórico tem a versão trimestral com o sufixo Quarterly, como
balanceSheetHistoryQuarterly. Os módulos defaultKeyStatistics e
financialData têm as versões ...History e ...HistoryQuarterly.
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/quote/BBDC4?modules=incomeStatementHistoryQuarterly,cashflowHistory"Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Ticker(s) de ativos separados por vírgula (ex: PETR4 ou PETR4,VALE3,ITUB4)
Período para dados históricos de preço
Value in
Intervalo/granularidade dos dados históricos
Value in
Data inicial para dados históricos (formato YYYY-MM-DD)
Data final para dados históricos (formato YYYY-MM-DD)
Incluir histórico de dividendos e JCP
Value in
Incluir preços OHLC originais armazenados no banco da brapi para intervalos diários. Use includeRaw=true. Disponível no plano Pro.
Value in
Módulos de dados adicionais separados por vírgula
Token de autenticação (alternativa ao header Authorization)
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/quote/PETR4,VALE3"{ "results": [ { "symbol": "PETR4", "shortName": "PETR4", "longName": "Petroleo Brasileiro SA Pfd", "currency": "BRL", "regularMarketPrice": 36.65, "regularMarketDayHigh": 37.27, "regularMarketDayLow": 36.45, "regularMarketDayRange": "36.45 - 37.27", "regularMarketChange": -0.35, "regularMarketChangePercent": -0.95, "regularMarketTime": "2026-02-08T16:24:54.000Z", "marketCap": 483937892568, "regularMarketVolume": 27681100, "regularMarketPreviousClose": 36.7, "regularMarketOpen": 37.21, "fiftyTwoWeekRange": "28.86 - 38.66", "fiftyTwoWeekLow": 28.86, "fiftyTwoWeekHigh": 38.66, "priceEarnings": 6.09, "earningsPerShare": 6.01, "logourl": "https://icons.brapi.dev/icons/PETR4.svg" } ], "requestedAt": "2026-02-08T16:25:28.170Z", "took": 3}