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 + dividendos + estatísticas-chave
curl "https://brapi.dev/api/quote/PETR4?range=6mo&interval=1d&dividends=true&modules=balanceSheetHistory,defaultKeyStatistics&token=SEU_TOKEN"

Módulos Disponíveis:

• summaryProfile — Perfil da empresa (CNPJ, 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:

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)

{
  "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
}