Cotação, Dividendos e Dados Financeiros

Consultar Cotação e Dados de Ativos

O ENDPOINT MAIS IMPORTANTE DA API. Obtém dados detalhados e abrangentes de um ou múltiplos ativos (ações, FIIs, BDRs) em uma única requisição. Combine cotações em tempo real, dados históricos, fundamentos e dividendos conforme necessário.

Funcionalidades:

• Cotação em Tempo Real: Preço atual, variação absoluta e percentual, volume, máxima/mínima do dia, range de 52 semanas.
• Dados Históricos: Preços OHLCV (Open, High, Low, Close, Volume) com intervalos flexíveis (1d, 5d, 1wk, 1mo, 3mo) e períodos (1d até max).
• Fundamentos: Balanço Patrimonial, DRE, Fluxo de Caixa, DVA, Indicadores-chave (P/L, P/VP, ROE, etc) via parâmetro modules.
• Dividendos: Histórico completo de proventos em dinheiro (dividendos, JCP) e bonificações.

Autenticação:

Requer token Bearer no header ou como query param. Tickers de teste PETR4 e VALE3 funcionam sem autenticação.

# Via header (recomendado)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/PETR4"

# Via query param
curl "https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN"

Exemplos de Requisição:

# Simples: apenas cotação atual
curl "https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN"

# Múltiplos tickers em uma requisição
curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4?token=SEU_TOKEN"

# Com dados históricos (últimos 12 meses, diário)
curl "https://brapi.dev/api/quote/PETR4?range=1y&interval=1d&token=SEU_TOKEN"

# Com módulos de fundamentos (balanço e DRE)
curl "https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistory,incomeStatementHistory&token=SEU_TOKEN"

# Completo: histórico + fundamentos + dividendos
curl "https://brapi.dev/api/quote/PETR4?range=6mo&interval=1d&fundamental=true&dividends=true&modules=balanceSheetHistory,defaultKeyStatistics&token=SEU_TOKEN"

Módulos Disponíveis:

• summaryProfile — Perfil da empresa (setor, descrição, website, funcionários)
• balanceSheetHistory — Balanço Patrimonial anual
• balanceSheetHistoryQuarterly — Balanço Patrimonial trimestral
• incomeStatementHistory — DRE anual (Demonstração de Resultado do Exercício)
• incomeStatementHistoryQuarterly — DRE trimestral
• financialData — Indicadores financeiros atuais (TTM - Trailing Twelve Months)
• financialDataHistory — Histórico anual de indicadores financeiros
• financialDataHistoryQuarterly — Histórico trimestral de indicadores financeiros
• defaultKeyStatistics — Estatísticas-chave (P/L, P/VP, ROE, Dividend Yield, etc)
• defaultKeyStatisticsHistory — Histórico anual de estatísticas-chave
• defaultKeyStatisticsHistoryQuarterly — Histórico trimestral de estatísticas-chave
• cashflowHistory — Fluxo de Caixa anual
• cashflowHistoryQuarterly — Fluxo de Caixa trimestral
• valueAddedHistory — DVA anual (Demonstração de Valor Adicionado)
• valueAddedHistoryQuarterly — DVA trimestral

Intervalos Válidos (histórico):

• 1d — Diário
• 5d — 5 dias
• 1wk — Semanal
• 1mo — Mensal
• 3mo — Trimestral

Períodos Válidos (range):

• 1d — Último dia
• 5d — Últimos 5 dias
• 1mo — Último mês
• 3mo — Últimos 3 meses
• 6mo — Últimos 6 meses
• 1y — Último ano
• 2y — Últimos 2 anos
• 5y — Últimos 5 anos
• 10y — Últimos 10 anos
• ytd — Ano até hoje
• max — Máximo disponível

Campos Principais da Resposta:

• symbol — Ticker do ativo (ex: PETR4)
• shortName — Nome curto da empresa
• currency — Moeda (BRL)
• regularMarketPrice — Preço atual em BRL
• regularMarketChange — Variação absoluta
• regularMarketChangePercent — Variação percentual (%)
• regularMarketVolume — Volume de negociação do dia
• regularMarketDayHigh — Máxima do dia
• regularMarketDayLow — Mínima do dia
• fiftyTwoWeekHigh — Máxima de 52 semanas
• fiftyTwoWeekLow — Mínima de 52 semanas
• marketCap — Capitalização de mercado
• historicalDataPrice — Array de dados OHLCV (quando range/interval fornecidos)
• dividendsData — Histórico de dividendos (quando dividends=true)

Tickers Populares (Teste):

• PETR4 — Petrobras (Energia)
• VALE3 — Vale (Mineração)
• ITUB4 — Itaú Unibanco (Financeiro)
• BBDC4 — Bradesco (Financeiro)
• ABEV3 — Ambev (Consumo)
• WEGE3 — WEG (Indústria)
• RENT3 — Localiza (Transporte)
• BBAS3 — Banco do Brasil (Financeiro)
• MGLU3 — Magazine Luiza (Varejo)

Fonte dos Dados:

B3 (Bolsa de Valores do Brasil), TradingView, CVM (Comissão de Valores Mobiliários)

Plano Mínimo: Gratuito (limitado a 1 ticker/requisição e módulos básicos) Autenticação: Necessária para produção (tickers de teste PETR4 e VALE3 funcionam sem token)

Path Parameters

Query Parameters

Response Body