Ações
Ações e ativos da B3
Carregando conteúdo...
FOR LLMs: add .md to any documentation URL to get the page as Markdown. Example: /docs/acoes/dividendos.md. The index of all pages is at /llms.txt.
Carregando documentação...
Cotação de um ou mais ativos brasileiros. A mesma resposta pode trazer histórico de preços, proventos e dados das demonstrações financeiras.
Use para integrações que já usam este formato. Para integrações novas, use os endpoints /api/v2/stocks/*, que trazem um tipo de dado por chamada. Veja o guia de migração.
Este é o endpoint original da brapi. Ele continua ativo e não tem data de remoção.
AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Seus preços históricos e proventos continuam separados por classe. Os campos historicalSymbol e dividendsSymbol identificam o ticker desses históricos.
A resposta sempre traz a cotação: preço, variação, volume, máxima e mínima do dia, faixa de 52 semanas e marketCap. Estes parâmetros adicionam outros dados:
range e interval, ou startDate e endDate: historicalDataPrice, a série de preços.includeRaw=true: os preços originais sem ajuste rawOpen, rawHigh, rawLow e rawClose, só em intervalos diários. Exige o plano Pro.dividends=true: dividendsData, com dividendos, JCP e eventos em ações.modules: um objeto para cada módulo pedido.Módulos aceitos em modules, separados por vírgula:
summaryProfile: cadastro da empresa.defaultKeyStatistics: múltiplos dos últimos 12 meses, como P/L, P/VP e dividend yield.financialData: receita, EBITDA, margens e dívida dos últimos 12 meses.balanceSheetHistory: balanço patrimonial anual.incomeStatementHistory: DRE anual.cashflowHistory: fluxo de caixa anual.valueAddedHistory: DVA anual.Cada módulo de demonstração tem uma versão trimestral com o sufixo Quarterly, como balanceSheetHistoryQuarterly. defaultKeyStatistics e financialData também aceitam os sufixos History e HistoryQuarterly. Os dados trimestrais seguem as mesmas regras dos endpoints v2 de DRE, fluxo de caixa e DVA.
O plano define os valores aceitos em range, interval e modules. Um valor fora do plano retorna erro.
PETR4, MGLU3, VALE3 e ITUB4 respondem sem token. Se a chamada juntar um deles com outro ticker, ela exige token.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Tickers separados por vírgula. Ex.: PETR4,VALE3.
Janela relativa da série de preços.
Value in
Intervalo entre os pontos da série de preços.
Value in
Data inicial da série de preços no formato YYYY-MM-DD.
Data final da série de preços no formato YYYY-MM-DD. Sem startDate, range conta para trás a partir desta data.
Inclui dividendsData com dividendos, JCP e eventos em ações.
Value in
Inclui os preços originais sem ajuste (rawOpen, rawHigh, rawLow, rawClose) em intervalos diários. Exige o plano Pro.
Value in
Módulos extras separados por vírgula.
Token de acesso. Use no lugar do 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}