Cotação de ativos (v1)
Changed onCotaçã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.
Request
- Base URLhttps://brapi.dev
- URLhttps://brapi.dev/api/quote/{tickers}
- AuthHTTP bearer
Path parameters
Tickers separados por vírgula. Ex.: PETR4,VALE3.
Query parameters
Janela relativa da série de preços.
Intervalo entre os pontos da série de preços.
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.
Inclui os preços originais sem ajuste (rawOpen, rawHigh, rawLow, rawClose) em intervalos diários. Exige o plano Pro.
Módulos extras separados por vírgula.
Token de acesso. Use no lugar do header Authorization.
Response
Dados dos ativos recuperados com sucesso.
Example response
{
"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
}Changes
- info
added the optional property
/////to the response with the status
- info
- info
added the required property
////to the response with the status - info
added the required property
////to the response with the status
- info