Cotação, Dividendos e Dados Financeiros
Endpoints para consulta de dados relacionados a ativos negociados na B3, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA).
Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Path Parameters
Ticker(s) de ativos separados por vírgula (ex: PETR4 ou PETR4,VALE3,ITUB4)
Query Parameters
Período para dados históricos de preço
"1d" | "2d" | "5d" | "7d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "10y" | "ytd" | "max"Intervalo/granularidade dos dados históricos
"1m" | "2m" | "5m" | "15m" | "30m" | "60m" | "90m" | "1h" | "1d" | "5d" | "1wk" | "1mo" | "3mo"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
"true" | "false"Módulos de dados adicionais separados por vírgula
Token de autenticação (alternativa ao header Authorization)
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/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
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Limite de requisições excedido. Tente novamente mais tarde.",
"code": "RATE_LIMIT_EXCEEDED"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}