--- title: "Cotação de ativos (v1)" method: GET path: "/api/quote/{tickers}" tags: ["Cotações"] --- # Cotação de ativos (v1) `GET /api/quote/{tickers}` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/quote/{tickers}` - Auth: HTTP bearer Cotaçã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](https://brapi.dev/docs/acoes/migracao-v2). 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](https://brapi.dev/docs/acoes/dre), [fluxo de caixa](https://brapi.dev/docs/acoes/fluxo-de-caixa) e [DVA](https://brapi.dev/docs/acoes/valor-adicionado). 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. ## Path parameters - `tickers` string, required: Tickers separados por vírgula. Ex.: PETR4,VALE3. ## Query parameters - `range` '1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max': Janela relativa da série de preços. - `interval` '1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo': Intervalo entre os pontos da série de preços. - `startDate` string: Data inicial da série de preços no formato YYYY-MM-DD. - `endDate` string: Data final da série de preços no formato YYYY-MM-DD. Sem `startDate`, `range` conta para trás a partir desta data. - `dividends` 'true' | 'false': Inclui `dividendsData` com dividendos, JCP e eventos em ações. - `includeRaw` 'true' | 'false': Inclui os preços originais sem ajuste (`rawOpen`, `rawHigh`, `rawLow`, `rawClose`) em intervalos diários. Exige o plano Pro. - `modules` string: Módulos extras separados por vírgula. - `token` string: Token de acesso. Use no lugar do header `Authorization`. ## Response `200` Dados dos ativos recuperados com sucesso. - QuoteTickersResponse - `results` QuoteResult[], required - `symbol` string, required: Ticker do ativo. Ex.: PETR4, ^BVSP. - `requestedSymbol` string: Ticker enviado quando a cotação pertence a outro ticker. - `dividendsSymbol` string: Ticker do histórico de proventos quando ele difere do ticker da cotação. - `historicalSymbol` string: Ticker do histórico de preços quando ele difere do ticker da cotação. - `currency` string, required: Moeda dos valores. Em geral, BRL. - `shortName` string, nullable, required: Nome curto do ativo. - `longName` string, nullable, required: Nome completo da empresa. - `regularMarketPrice` number, nullable, required: Preço do último negócio. - `regularMarketChange` number, nullable, required: Variação do preço no dia em relação ao fechamento anterior, em reais. - `regularMarketChangePercent` number, nullable, required: Variação do preço no dia, em porcentagem. - `regularMarketTime` string, nullable, required: Horário da cotação em ISO 8601. - `regularMarketDayHigh` number, nullable, required: Preço máximo do dia. - `regularMarketDayLow` number, nullable, required: Preço mínimo do dia. - `regularMarketDayRange` string, nullable, required: Faixa de preço do dia no formato mínimo - máximo. - `regularMarketVolume` number, nullable, required: Volume negociado no dia. - `regularMarketPreviousClose` number, nullable, required: Fechamento do pregão anterior. - `regularMarketOpen` number, nullable, required: Preço de abertura do dia. - `averageDailyVolume3Month` number, nullable, required: Volume médio diário dos últimos 3 meses. - `averageDailyVolume10Day` number, nullable, required: Volume médio diário dos últimos 10 dias. - `fiftyTwoWeekLow` number, nullable, required: Preço mínimo das últimas 52 semanas. - `fiftyTwoWeekHigh` number, nullable, required: Preço máximo das últimas 52 semanas. - `fiftyTwoWeekRange` string, nullable, required: Faixa de preço das últimas 52 semanas no formato mínimo - máximo. - `fiftyTwoWeekLowChange` number, nullable, required: Diferença entre o preço atual e o mínimo de 52 semanas. - `fiftyTwoWeekHighChange` number, nullable, required: Diferença entre o preço atual e o máximo de 52 semanas. - `fiftyTwoWeekHighChangePercent` number, nullable, required: Diferença entre o preço atual e o máximo de 52 semanas, em porcentagem. - `twoHundredDayAverage` number, nullable, required: Média móvel de 200 dias. - `twoHundredDayAverageChange` number, nullable, required: Diferença entre o preço atual e a média de 200 dias. - `twoHundredDayAverageChangePercent` number, nullable, required: Diferença entre o preço atual e a média de 200 dias, em porcentagem. - `marketCap` number, nullable, required: Valor de mercado, em reais. - `priceEarnings` number, nullable, required: Preço sobre lucro (P/L). - `earningsPerShare` number, nullable, required: Lucro por ação (LPA) dos últimos 12 meses. - `logourl` string, nullable, required: URL do logo do ativo. - `usedInterval` string, nullable, required: Intervalo usado na série de preços. - `usedRange` string, nullable, required: Janela usada na série de preços. Vem como `custom` quando `startDate` é informado. - `validRanges` string[]: Valores aceitos em `range`. - `validIntervals` string[]: Valores aceitos em `interval`. - `historicalDataPrice` HistoricalDataPrice[]: Série de preços. Vem quando a requisição define a janela. - `date` integer, required: Data do ponto em Unix timestamp, em segundos. - `open` number, required: Preço de abertura no intervalo. - `high` number, required: Preço máximo no intervalo. - `low` number, required: Preço mínimo no intervalo. - `close` number, required: Preço de fechamento no intervalo. - `volume` integer, required: Volume negociado no intervalo. - `adjustedClose` number, required: Fechamento ajustado por proventos, desdobramentos e grupamentos. Use para calcular retorno. - `rawOpen` number, nullable: Preço de abertura original, sem ajuste. Vem com `includeRaw=true` em intervalos diários. Pode ser nulo. - `rawHigh` number, nullable: Preço máximo original, sem ajuste. Vem com `includeRaw=true` em intervalos diários. Pode ser nulo. - `rawLow` number, nullable: Preço mínimo original, sem ajuste. Vem com `includeRaw=true` em intervalos diários. Pode ser nulo. - `rawClose` number, nullable: Preço de fechamento original, sem ajuste. Vem com `includeRaw=true` em intervalos diários. Pode ser nulo. - `dividendsData` DividendsData: Proventos. Na rota `/api/quote/{tickers}`, vem com `dividends=true`. Na rota `/api/v2/stocks/dividends`, não exige esse parâmetro. - `cashDividends` object[], required: Dividendos e JCP pagos em dinheiro. - `assetIssued` string, required: Código ISIN do ativo que dá direito ao provento. - `paymentDate` string, nullable, required: Data de pagamento. - `paymentDateIsDeadline` boolean, required: `true` quando a empresa informou só o prazo máximo do pagamento ("até 31/12/2026"). Nesse caso, `paymentDate` é o prazo e muda quando a empresa divulgar a data. - `verified` boolean, required: `true` quando o provento foi conferido em um documento publicado pela empresa ou pelo fundo. `false` quando vem de dados históricos que ainda não têm esse documento. - `rate` number, required: Valor por ação, em reais, na escala das cotações ajustadas por desdobramentos, grupamentos e bonificações (`close` do histórico). Um provento anterior a um desdobramento de 1 para 5 aparece dividido por 5. Em BDRs, o valor líquido por BDR, já sem o imposto no exterior, o IOF e a taxa da instituição depositária. - `rawRate` number, nullable: Valor pago por ação na data do provento, na escala dos preços sem ajuste. Vem com `includeRaw=true`. - `relatedTo` string, required: Período a que o provento se refere. Ex.: 1º Trimestre/2024. - `approvedOn` string, nullable, required: Data de aprovação. - `isinCode` string, required: Código ISIN. - `label` string, required: Tipo do provento: DIVIDENDO ou JCP. - `lastDatePrior` string, nullable, required: Data-com, o último dia para comprar o ativo e ter direito ao provento. - `exDate` string, nullable, required: Data ex, o primeiro dia sem direito ao provento. Pode ser nulo. - `remarks` string, required: Observações. - `bdr` object: Só em BDRs: o provento no exterior e os descontos até chegar em `rate`. Campos não informados no aviso vêm nulos. - `currency` string, nullable, required: Moeda do provento no exterior. Ex.: USD. - `grossPerShare` number, nullable, required: Valor bruto por ação no exterior, na moeda do provento. - `ratio` string, nullable, required: Ações no exterior para BDRs. Ex.: "1:4" quando 1 ação equivale a 4 BDRs. - `grossPerBdr` number, nullable, required: Valor bruto por BDR, na moeda do provento. - `fxRate` number, nullable, required: Câmbio usado na conversão para reais. - `fxDate` string, nullable, required: Data do câmbio (AAAA-MM-DD). - `grossBrlPerBdr` number, nullable, required: Valor por BDR em reais, antes dos descontos no Brasil. - `withholdingTaxPercent` number, nullable, required: Imposto retido no exterior, em %. - `iofPercent` number, nullable, required: IOF sobre o câmbio, em %. - `depositaryFeePercent` number, nullable, required: Taxa da instituição depositária, em % do provento. - `final` boolean, nullable, required: `false` enquanto o valor é uma estimativa. `true` quando é o valor definitivo. - `stockDividends` object[], required: Eventos em ações: desdobramentos, grupamentos e bonificações. - `assetIssued` string, required: Código ISIN do ativo que dá direito ao provento. - `factor` number, required: Fator do evento. Ex.: 2 em um desdobramento de 2 para 1. - `completeFactor` string, required: Fator em texto. Ex.: 2 para 1. - `approvedOn` string, nullable, required: Data de aprovação. - `isinCode` string, required: Código ISIN. - `label` string, required: Tipo do evento: DESDOBRAMENTO, GRUPAMENTO ou BONIFICAÇÃO. - `lastDatePrior` string, nullable, required: Data-com, o último dia para comprar o ativo e ter direito ao evento. - `exDate` string, nullable, required: Data ex, o primeiro dia sem direito ao evento. Pode ser nulo. - `remarks` string, required: Observações. - `subscriptions` unknown[], required: Direitos de subscrição. - unknown - `summaryProfile` SummaryProfile: Cadastro da empresa. Vem com o módulo `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[]: Balanço patrimonial anual. - `symbol` string, required: Ticker do ativo - `type` string, required: Tipo (yearly, quarterly) - `endDate` string, required: Data de referência - `consolidationType` 'consolidated' | 'individual', required: Base do período: `consolidated` (consolidado) ou `individual` (só a controladora). - `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[]: Balanço patrimonial trimestral. - `symbol` string, required: Ticker do ativo - `type` string, required: Tipo (yearly, quarterly) - `endDate` string, required: Data de referência - `consolidationType` 'consolidated' | 'individual', required: Base do período: `consolidated` (consolidado) ou `individual` (só a controladora). - `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 dos últimos 12 meses. - `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 atribuível aos controladores nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `earningsGrowthAnnual`. - `revenueGrowth` number, nullable, required: Crescimento da receita nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `revenueGrowthAnnual`. - `earningsGrowthAnnual` number, nullable, required: Crescimento do lucro atribuível aos controladores no último exercício completo, contra o exercício anterior. - `revenueGrowthAnnual` number, nullable, required: Crescimento da receita líquida no último exercício completo, contra o 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[]: Dados financeiros anuais. - `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 atribuível aos controladores nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `earningsGrowthAnnual`. - `revenueGrowth` number, nullable, required: Crescimento da receita nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `revenueGrowthAnnual`. - `earningsGrowthAnnual` number, nullable, required: Crescimento do lucro atribuível aos controladores no último exercício completo, contra o exercício anterior. - `revenueGrowthAnnual` number, nullable, required: Crescimento da receita líquida no último exercício completo, contra o 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[]: Dados financeiros trimestrais. - `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 atribuível aos controladores nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `earningsGrowthAnnual`. - `revenueGrowth` number, nullable, required: Crescimento da receita nos últimos 4 trimestres, contra os 4 trimestres anteriores. Para a variação anual, use `revenueGrowthAnnual`. - `earningsGrowthAnnual` number, nullable, required: Crescimento do lucro atribuível aos controladores no último exercício completo, contra o exercício anterior. - `revenueGrowthAnnual` number, nullable, required: Crescimento da receita líquida no último exercício completo, contra o 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 que apontam um endpoint mais adequado para o pedido. A requisição funciona mesmo assim. - `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 ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `429`: Limite de requisições excedido. - `500`: Erro interno do servidor. ## Changes - **2026-10-29** `dae9d382e9b7`: 1 info - added the optional property `results/items/dividendsData/cashDividends/items/bdr` to the response with the `200` status - **2026-10-25** `19f0a0c3689f`: 2 info - added the required property `results/items/balanceSheetHistory/items/consolidationType` to the response with the `200` status - added the required property `results/items/balanceSheetHistoryQuarterly/items/consolidationType` to the response with the `200` status - **2026-10-16** `62eafb05acb0`: 5 info - added the optional property `results/items/dividendsSymbol` to the response with the `200` status - added the optional property `results/items/historicalSymbol` to the response with the `200` status - added the optional property `results/items/requestedSymbol` to the response with the `200` status - added the required property `results/items/dividendsData/cashDividends/items/paymentDateIsDeadline` to the response with the `200` status - …1 more - **2026-09-04** `2dc90b0ebf1f`: 1 info - added the optional property `results/items/dividendsData/cashDividends/items/rawRate` to the response with the `200` status - **2026-09-04** `623e15020627`: 2 info - added the required property `results/items/dividendsData/cashDividends/items/exDate` to the response with the `200` status - added the required property `results/items/dividendsData/stockDividends/items/exDate` to the response with the `200` status [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/quote/:tickers/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)