---
title: "Consultar Cotação e Dados de Ativos"
method: GET
path: "/api/quote/{tickers}"
tags: ["Cotações"]
---

# Consultar Cotação e Dados de Ativos

`GET /api/quote/{tickers}`

**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.

```bash
# 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:
```bash
# 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)

## Path parameters

- `tickers` string, required — Ticker(s) de ativos separados por vírgula (ex: PETR4 ou PETR4,VALE3,ITUB4)

## Query parameters

- `range` '1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max' — Período para dados históricos de preço
- `interval` '1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo' — Intervalo/granularidade dos dados históricos
- `startDate` string — Data inicial para dados históricos (formato YYYY-MM-DD)
- `endDate` string — Data final para dados históricos (formato YYYY-MM-DD)
- `dividends` 'true' | 'false' — Incluir histórico de dividendos e JCP
- `modules` string — Módulos de dados adicionais separados por vírgula
- `token` string — Token de autenticação (alternativa ao header Authorization)

## Response `200`

Dados dos ativos recuperados com sucesso.

- QuoteTickersResponse
  - `results` QuoteResult[], required
    - `symbol` string, required — Ticker (símbolo) do ativo (ex: PETR4, ^BVSP)
    - `currency` string, required — Moeda na qual os valores são expressos (geralmente BRL)
    - `shortName` string, nullable, required — Nome curto ou abreviado da empresa
    - `longName` string, nullable, required — Nome completo da empresa
    - `regularMarketPrice` number, nullable, required — Preço atual ou do último negócio registrado
    - `regularMarketChange` number, nullable, required — Variação absoluta do preço no dia em relação ao fechamento anterior
    - `regularMarketChangePercent` number, nullable, required — Variação percentual do preço no dia
    - `regularMarketTime` string, nullable, required — Data/hora da última atualização da cotação (ISO 8601)
    - `regularMarketDayHigh` number, nullable, required — Preço máximo atingido no dia
    - `regularMarketDayLow` number, nullable, required — Preço mínimo atingido no dia
    - `regularMarketDayRange` string, nullable, required — Intervalo de preço do dia (Mínimo - Máximo)
    - `regularMarketVolume` number, nullable, required — Volume financeiro negociado no dia
    - `regularMarketPreviousClose` number, nullable, required — Preço de fechamento do pregão anterior
    - `regularMarketOpen` number, nullable, required — Preço de abertura no dia
    - `averageDailyVolume3Month` number, nullable, required — Média do volume diário nos últimos 3 meses
    - `averageDailyVolume10Day` number, nullable, required — Média do volume diário nos últimos 10 dias
    - `fiftyTwoWeekLow` number, nullable, required — Preço mínimo nas últimas 52 semanas
    - `fiftyTwoWeekHigh` number, nullable, required — Preço máximo nas últimas 52 semanas
    - `fiftyTwoWeekRange` string, nullable, required — Intervalo de preço das últimas 52 semanas
    - `fiftyTwoWeekLowChange` number, nullable, required — Variação entre preço atual e mínimo de 52 semanas
    - `fiftyTwoWeekHighChange` number, nullable, required — Variação entre preço atual e máximo de 52 semanas
    - `fiftyTwoWeekHighChangePercent` number, nullable, required — Variação percentual entre preço atual e máximo de 52 semanas
    - `twoHundredDayAverage` number, nullable, required — Média móvel de 200 dias
    - `twoHundredDayAverageChange` number, nullable, required — Variação entre preço atual e média de 200 dias
    - `twoHundredDayAverageChangePercent` number, nullable, required — Variação percentual entre preço atual e média de 200 dias
    - `marketCap` number, nullable, required — Capitalização de mercado total
    - `priceEarnings` number, nullable, required — Indicador Preço/Lucro (P/L)
    - `earningsPerShare` number, nullable, required — Lucro Por Ação (LPA) TTM
    - `logourl` string, nullable, required — URL do logo do ativo
    - `usedInterval` string, nullable, required — Intervalo efetivamente utilizado para dados históricos
    - `usedRange` string, nullable, required — Período efetivamente utilizado para dados históricos
    - `validRanges` string[] — Valores válidos para o parâmetro range
    - `validIntervals` string[] — Valores válidos para o parâmetro interval
    - `historicalDataPrice` HistoricalDataPrice[] — Série histórica de preços (quando range/interval fornecidos)
      - `date` integer, required — Data do pregão ou do ponto de dados, representada como um timestamp UNIX (número de segundos desde 1970-01-01 UTC).
      - `open` number, required — Preço de abertura do ativo no intervalo (dia, semana, mês, etc.).
      - `high` number, required — Preço máximo atingido pelo ativo no intervalo.
      - `low` number, required — Preço mínimo atingido pelo ativo no intervalo.
      - `close` number, required — Preço de fechamento do ativo no intervalo.
      - `volume` integer, required — Volume financeiro negociado no intervalo.
      - `adjustedClose` number, required — Preço de fechamento ajustado para proventos (dividendos, JCP, bonificações, etc.) e desdobramentos/grupamentos.
    - `dividendsData` DividendsData — Dados de dividendos (quando dividends=true)
      - `cashDividends` object[], required — Histórico de dividendos e JCP em dinheiro
        - `assetIssued` string, required — Código ISIN do ativo emissor
        - `paymentDate` string, nullable, required — Data de pagamento
        - `rate` number, required — Valor por ação
        - `relatedTo` string, required — Período de referência
        - `approvedOn` string, nullable, required — Data de aprovação
        - `isinCode` string, required — Código ISIN
        - `label` string, required — Tipo (DIVIDENDO, JCP)
        - `lastDatePrior` string, nullable, required — Data-com (último dia antes da data ex)
        - `remarks` string, required — Observações
      - `stockDividends` object[], required — Histórico de bonificações e desdobramentos
        - `assetIssued` string, required — Código ISIN do ativo emissor
        - `factor` number, required — Fator do desdobramento/grupamento
        - `completeFactor` string, required — Fator completo (ex: 2 para 1)
        - `approvedOn` string, nullable, required — Data de aprovação
        - `isinCode` string, required — Código ISIN
        - `label` string, required — Tipo (DESDOBRAMENTO, GRUPAMENTO)
        - `lastDatePrior` string, nullable, required — Data de corte
        - `remarks` string, required — Observações
      - `subscriptions` unknown[], required — Histórico de subscrições
        - unknown
    - `summaryProfile` SummaryProfile — Perfil da empresa (quando modules inclui summaryProfile)
      - `symbol` string, required — Ticker do ativo
      - `cnpj` string, nullable, required — CNPJ da empresa
      - `address1` string, nullable, required — Endereço linha 1
      - `address2` string, nullable, required — Endereço linha 2
      - `address3` string, nullable, required — Endereço linha 3
      - `city` string, nullable, required — Cidade
      - `state` string, nullable, required — Estado
      - `zip` string, nullable, required — CEP
      - `country` string, nullable, required — País
      - `phone` string, nullable, required — Telefone
      - `fax` string, nullable, required — Fax
      - `website` string, nullable, required — Website
      - `industry` string, nullable, required — Setor
      - `industryKey` string, nullable, required — Chave do setor
      - `industryDisp` string, nullable, required — Nome do setor
      - `sector` string, nullable, required — Segmento
      - `sectorKey` string, nullable, required — Chave do segmento
      - `sectorDisp` string, nullable, required — Nome do segmento
      - `longBusinessSummary` string, nullable, required — Descrição da empresa
      - `fullTimeEmployees` number, nullable, required — Número de funcionários
      - `companyOfficers` unknown[], required — Diretoria
        - unknown
      - `updatedAt` string, nullable, required — Data de atualização
    - `balanceSheetHistory` BalanceSheetEntry[] — Histórico anual do Balanço Patrimonial
      - `symbol` string, required — Ticker do ativo
      - `type` string, required — Tipo (yearly, quarterly)
      - `endDate` string, required — Data de referência
      - `cash` number, nullable, required — Caixa
      - `shortTermInvestments` number, nullable, required — Investimentos de curto prazo
      - `netReceivables` number, nullable, required — Contas a receber
      - `inventory` number, nullable, required — Estoques
      - `otherCurrentAssets` number, nullable, required — Outros ativos circulantes
      - `totalCurrentAssets` number, nullable, required — Total ativo circulante
      - `longTermInvestments` number, nullable, required — Investimentos de longo prazo
      - `propertyPlantEquipment` number, nullable, required — Imobilizado
      - `otherAssets` number, nullable, required — Outros ativos
      - `totalAssets` number, nullable, required — Total de ativos
      - `accountsPayable` number, nullable, required — Fornecedores
      - `shortLongTermDebt` number, nullable, required — Dívida de curto/longo prazo
      - `longTermDebt` number, nullable, required — Dívida de longo prazo
      - `totalCurrentLiabilities` number, nullable, required — Passivo circulante total
      - `totalLiab` number, nullable, required — Passivo total
      - `totalStockholderEquity` number, nullable, required — Patrimônio líquido
      - `updatedAt` string, nullable, required — Data de atualização
    - `balanceSheetHistoryQuarterly` BalanceSheetEntry[] — Histórico trimestral do Balanço Patrimonial
      - `symbol` string, required — Ticker do ativo
      - `type` string, required — Tipo (yearly, quarterly)
      - `endDate` string, required — Data de referência
      - `cash` number, nullable, required — Caixa
      - `shortTermInvestments` number, nullable, required — Investimentos de curto prazo
      - `netReceivables` number, nullable, required — Contas a receber
      - `inventory` number, nullable, required — Estoques
      - `otherCurrentAssets` number, nullable, required — Outros ativos circulantes
      - `totalCurrentAssets` number, nullable, required — Total ativo circulante
      - `longTermInvestments` number, nullable, required — Investimentos de longo prazo
      - `propertyPlantEquipment` number, nullable, required — Imobilizado
      - `otherAssets` number, nullable, required — Outros ativos
      - `totalAssets` number, nullable, required — Total de ativos
      - `accountsPayable` number, nullable, required — Fornecedores
      - `shortLongTermDebt` number, nullable, required — Dívida de curto/longo prazo
      - `longTermDebt` number, nullable, required — Dívida de longo prazo
      - `totalCurrentLiabilities` number, nullable, required — Passivo circulante total
      - `totalLiab` number, nullable, required — Passivo total
      - `totalStockholderEquity` number, nullable, required — Patrimônio líquido
      - `updatedAt` string, nullable, required — Data de atualização
    - `financialData` FinancialDataEntry — Dados financeiros e indicadores TTM
      - `symbol` string, required — Ticker do ativo
      - `currentPrice` number, nullable, required — Preço atual
      - `ebitda` number, nullable, required — EBITDA
      - `quickRatio` number, nullable, required — Liquidez seca
      - `currentRatio` number, nullable, required — Liquidez corrente
      - `debtToEquity` number, nullable, required — Dívida/PL
      - `revenuePerShare` number, nullable, required — Receita por ação
      - `returnOnAssets` number, nullable, required — ROA
      - `returnOnEquity` number, nullable, required — ROE
      - `earningsGrowth` number, nullable, required — Crescimento do lucro do controlador (TTM) — variação dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores, usando Lucro Líquido Atribuível aos Controladores. Para crescimento anual (DRE de exercício vs. exercício anterior), use earningsGrowthAnnual.
      - `revenueGrowth` number, nullable, required — Crescimento da receita (TTM) — variação da receita dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores. Para crescimento anual (DRE de exercício vs. exercício anterior), use revenueGrowthAnnual.
      - `earningsGrowthAnnual` number, nullable, required — Crescimento anual do lucro do controlador — variação do Lucro Líquido Atribuível aos Controladores do último exercício social completo em relação ao exercício anterior.
      - `revenueGrowthAnnual` number, nullable, required — Crescimento anual da receita — variação da Receita Líquida do último exercício social completo em relação ao exercício anterior.
      - `grossMargins` number, nullable, required — Margem bruta
      - `ebitdaMargins` number, nullable, required — Margem EBITDA
      - `operatingMargins` number, nullable, required — Margem operacional
      - `profitMargins` number, nullable, required — Margem de lucro
      - `totalCash` number, nullable, required — Caixa total
      - `totalCashPerShare` number, nullable, required — Caixa por ação
      - `totalDebt` number, nullable, required — Dívida total
      - `totalRevenue` number, nullable, required — Receita total
      - `grossProfits` number, nullable, required — Lucro bruto
      - `operatingCashflow` number, nullable, required — Fluxo de caixa operacional
      - `freeCashflow` number, nullable, required — Fluxo de caixa livre
      - `financialCurrency` string, nullable, required — Moeda
      - `updatedAt` string, nullable, required — Data de atualização
      - `type` string, nullable, required — Tipo (ttm, yearly, quarterly)
    - `financialDataHistory` FinancialDataEntry[] — Histórico anual de dados financeiros
      - `symbol` string, required — Ticker do ativo
      - `currentPrice` number, nullable, required — Preço atual
      - `ebitda` number, nullable, required — EBITDA
      - `quickRatio` number, nullable, required — Liquidez seca
      - `currentRatio` number, nullable, required — Liquidez corrente
      - `debtToEquity` number, nullable, required — Dívida/PL
      - `revenuePerShare` number, nullable, required — Receita por ação
      - `returnOnAssets` number, nullable, required — ROA
      - `returnOnEquity` number, nullable, required — ROE
      - `earningsGrowth` number, nullable, required — Crescimento do lucro do controlador (TTM) — variação dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores, usando Lucro Líquido Atribuível aos Controladores. Para crescimento anual (DRE de exercício vs. exercício anterior), use earningsGrowthAnnual.
      - `revenueGrowth` number, nullable, required — Crescimento da receita (TTM) — variação da receita dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores. Para crescimento anual (DRE de exercício vs. exercício anterior), use revenueGrowthAnnual.
      - `earningsGrowthAnnual` number, nullable, required — Crescimento anual do lucro do controlador — variação do Lucro Líquido Atribuível aos Controladores do último exercício social completo em relação ao exercício anterior.
      - `revenueGrowthAnnual` number, nullable, required — Crescimento anual da receita — variação da Receita Líquida do último exercício social completo em relação ao exercício anterior.
      - `grossMargins` number, nullable, required — Margem bruta
      - `ebitdaMargins` number, nullable, required — Margem EBITDA
      - `operatingMargins` number, nullable, required — Margem operacional
      - `profitMargins` number, nullable, required — Margem de lucro
      - `totalCash` number, nullable, required — Caixa total
      - `totalCashPerShare` number, nullable, required — Caixa por ação
      - `totalDebt` number, nullable, required — Dívida total
      - `totalRevenue` number, nullable, required — Receita total
      - `grossProfits` number, nullable, required — Lucro bruto
      - `operatingCashflow` number, nullable, required — Fluxo de caixa operacional
      - `freeCashflow` number, nullable, required — Fluxo de caixa livre
      - `financialCurrency` string, nullable, required — Moeda
      - `updatedAt` string, nullable, required — Data de atualização
      - `type` string, nullable, required — Tipo (ttm, yearly, quarterly)
    - `financialDataHistoryQuarterly` FinancialDataEntry[] — Histórico trimestral de dados financeiros
      - `symbol` string, required — Ticker do ativo
      - `currentPrice` number, nullable, required — Preço atual
      - `ebitda` number, nullable, required — EBITDA
      - `quickRatio` number, nullable, required — Liquidez seca
      - `currentRatio` number, nullable, required — Liquidez corrente
      - `debtToEquity` number, nullable, required — Dívida/PL
      - `revenuePerShare` number, nullable, required — Receita por ação
      - `returnOnAssets` number, nullable, required — ROA
      - `returnOnEquity` number, nullable, required — ROE
      - `earningsGrowth` number, nullable, required — Crescimento do lucro do controlador (TTM) — variação dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores, usando Lucro Líquido Atribuível aos Controladores. Para crescimento anual (DRE de exercício vs. exercício anterior), use earningsGrowthAnnual.
      - `revenueGrowth` number, nullable, required — Crescimento da receita (TTM) — variação da receita dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores. Para crescimento anual (DRE de exercício vs. exercício anterior), use revenueGrowthAnnual.
      - `earningsGrowthAnnual` number, nullable, required — Crescimento anual do lucro do controlador — variação do Lucro Líquido Atribuível aos Controladores do último exercício social completo em relação ao exercício anterior.
      - `revenueGrowthAnnual` number, nullable, required — Crescimento anual da receita — variação da Receita Líquida do último exercício social completo em relação ao exercício anterior.
      - `grossMargins` number, nullable, required — Margem bruta
      - `ebitdaMargins` number, nullable, required — Margem EBITDA
      - `operatingMargins` number, nullable, required — Margem operacional
      - `profitMargins` number, nullable, required — Margem de lucro
      - `totalCash` number, nullable, required — Caixa total
      - `totalCashPerShare` number, nullable, required — Caixa por ação
      - `totalDebt` number, nullable, required — Dívida total
      - `totalRevenue` number, nullable, required — Receita total
      - `grossProfits` number, nullable, required — Lucro bruto
      - `operatingCashflow` number, nullable, required — Fluxo de caixa operacional
      - `freeCashflow` number, nullable, required — Fluxo de caixa livre
      - `financialCurrency` string, nullable, required — Moeda
      - `updatedAt` string, nullable, required — Data de atualização
      - `type` string, nullable, required — Tipo (ttm, yearly, quarterly)
  - `guidance` GuidanceItem[] — Dicas contextuais quando a requisição funciona mas existe um endpoint mais adequado para o caso de uso.
    - `code` string, required
    - `message` string, required
    - `details` object, required
      - `suggestedEndpoint` string, required
      - `reason` string, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `429` — Limite de requisições excedido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)