brapi logobrapi
Obter Chave de API
Ações

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.

Buscar Cotação Detalhada de Ativos Financeiros

Este endpoint é a principal forma de obter informações detalhadas sobre um ou mais ativos financeiros (ações, FIIs, ETFs, BDRs, índices) listados na B3, identificados pelos seus respectivos tickers.

Funcionalidades Principais:

  • Cotação Atual: Retorna o preço mais recente, variação diária, máximas, mínimas, volume, etc.
  • Dados Históricos: Permite solicitar séries históricas de preços usando os parâmetros range e interval.
  • Dados Fundamentalistas: Opcionalmente, inclui dados fundamentalistas básicos (P/L, LPA) com o parâmetro fundamental=true.
  • Dividendos: Opcionalmente, inclui histórico de dividendos e JCP com dividends=true.
  • Módulos Adicionais: Permite requisitar conjuntos de dados financeiros mais aprofundados através do parâmetro modules (veja detalhes abaixo).

🧪 Ações de Teste (Sem Autenticação):

Para facilitar o desenvolvimento e teste, as seguintes 4 ações têm acesso irrestrito e não requerem autenticação:

  • PETR4 (Petrobras PN)
  • MGLU3 (Magazine Luiza ON)
  • VALE3 (Vale ON)
  • ITUB4 (Itaú Unibanco PN)

Importante: Você pode consultar essas ações sem token e com acesso a todos os recursos (históricos, módulos, dividendos). Porém, se misturar essas ações com outras na mesma requisição, a autenticação será obrigatória.

Autenticação:

Para outras ações (além das 4 de teste), é obrigatório fornecer um token de autenticação válido, seja via query parameter token ou via header Authorization: Bearer seu_token.

Exemplos de Requisição:

1. Cotação simples de PETR4 e VALE3 (ações de teste - sem token):

curl -X GET "https://brapi.dev/api/quote/PETR4,VALE3"

2. Cotação de MGLU3 com dados históricos do último mês (ação de teste - sem token):

curl -X GET "https://brapi.dev/api/quote/MGLU3?range=1mo&interval=1d"

3. Cotação de ITUB4 incluindo dividendos e dados fundamentalistas (ação de teste - sem token):

curl -X GET "https://brapi.dev/api/quote/ITUB4?fundamental=true&dividends=true"

4. Cotação de WEGE3 com Resumo da Empresa e Balanço Patrimonial Anual (via módulos - requer token):

curl -X GET "https://brapi.dev/api/quote/WEGE3?modules=summaryProfile,balanceSheetHistory&token=SEU_TOKEN"

5. Exemplo de requisição mista (requer token):

curl -X GET "https://brapi.dev/api/quote/PETR4,BBAS3?token=SEU_TOKEN"

Nota: Como BBAS3 não é uma ação de teste, toda a requisição requer autenticação, mesmo contendo PETR4.

Parâmetro modules (Detalhado):

O parâmetro modules é extremamente poderoso para enriquecer a resposta com dados financeiros detalhados. Você pode solicitar um ou mais módulos, separados por vírgula.

Módulos Disponíveis:

  • summaryProfile: Informações cadastrais da empresa (endereço, setor, descrição do negócio, website, número de funcionários).
  • balanceSheetHistory: Histórico anual do Balanço Patrimonial.
  • balanceSheetHistoryQuarterly: Histórico trimestral do Balanço Patrimonial.
  • defaultKeyStatistics: Principais estatísticas da empresa (Valor de Mercado, P/L, ROE, Dividend Yield, etc.) - TTM (Trailing Twelve Months).
  • defaultKeyStatisticsHistory: Histórico anual das Principais Estatísticas.
  • defaultKeyStatisticsHistoryQuarterly: Histórico trimestral das Principais Estatísticas.
  • incomeStatementHistory: Histórico anual da Demonstração do Resultado do Exercício (DRE).
  • incomeStatementHistoryQuarterly: Histórico trimestral da Demonstração do Resultado do Exercício (DRE).
  • financialData: Dados financeiros selecionados (Receita, Lucro Bruto, EBITDA, Dívida Líquida, Fluxo de Caixa Livre, Margens) - TTM (Trailing Twelve Months).
  • financialDataHistory: Histórico anual dos Dados Financeiros.
  • financialDataHistoryQuarterly: Histórico trimestral dos Dados Financeiros.
  • valueAddedHistory: Histórico anual da Demonstração do Valor Adicionado (DVA).
  • valueAddedHistoryQuarterly: Histórico trimestral da Demonstração do Valor Adicionado (DVA).
  • cashflowHistory: Histórico anual da Demonstração do Fluxo de Caixa (DFC).
  • cashflowHistoryQuarterly: Histórico trimestral da Demonstração do Fluxo de Caixa (DFC).

Exemplo de Uso do modules:

Para obter a cotação de BBDC4 junto com seu DRE trimestral e Fluxo de Caixa anual:

curl -X GET "https://brapi.dev/api/quote/BBDC4?modules=incomeStatementHistoryQuarterly,cashflowHistory&token=SEU_TOKEN"

Resposta:

A resposta é um objeto JSON contendo a chave results, que é um array. Cada elemento do array corresponde a um ticker solicitado e contém os dados da cotação e os módulos adicionais requisitados.

  • Sucesso (200 OK): Retorna os dados conforme solicitado.
  • Bad Request (400 Bad Request): Ocorre se um parâmetro for inválido (ex: range=invalid) ou se a formatação estiver incorreta.
  • Unauthorized (401 Unauthorized): Token inválido ou ausente.
  • Payment Required (402 Payment Required): Limite de requisições do plano atual excedido.
  • Not Found (404 Not Found): Um ou mais tickers solicitados não foram encontrados.
GET
/api/quote/{tickers}

Authorization

AuthorizationBearer <token>

Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.

In: header

Path Parameters

tickersstring

Obrigatório. Um ou mais tickers de ativos financeiros (ações, FIIs, índices, etc.) que você deseja consultar.

  • Múltiplos Tickers: Separe-os por vírgula (,).
  • Exemplos: PETR4, ITSA4,MGLU3, ^BVSP (para o índice Ibovespa).

Query Parameters

token?string

Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.

Formas de Envio:

  1. Query Parameter: Adicione ?token=SEU_TOKEN ao final da URL.
  2. HTTP Header: Inclua o header Authorization: Bearer SEU_TOKEN na sua requisição.

Ambos os métodos são aceitos, mas pelo menos um deles deve ser utilizado. Obtenha seu token em brapi.dev/dashboard.

range?string

Opcional. Define o período para os dados históricos de preço (historicalDataPrice). Se omitido, apenas a cotação mais recente é retornada (a menos que interval seja usado).

Valores Possíveis:

  • 1d: Último dia de pregão (intraday se interval for minutos/horas).
  • 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: Desde o início do ano atual (Year-to-Date).
  • max: Todo o período histórico disponível.
Value in"1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "10y" | "ytd" | "max"
interval?string

Opcional. Define a granularidade (intervalo) dos dados históricos de preço (historicalDataPrice). Requer que range também seja especificado.

Valores Possíveis:

  • 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h: Intervalos intraday (minutos/horas). Atenção: Disponibilidade pode variar conforme o range e o ativo.
  • 1d: Diário (padrão se range for especificado e interval omitido).
  • 5d: 5 dias.
  • 1wk: Semanal.
  • 1mo: Mensal.
  • 3mo: Trimestral.
Value in"1m" | "2m" | "5m" | "15m" | "30m" | "60m" | "90m" | "1h" | "1d" | "5d" | "1wk" | "1mo" | "3mo"
fundamental?boolean

Opcional. Booleano (true ou false). Se true, inclui dados fundamentalistas básicos na resposta, como Preço/Lucro (P/L) e Lucro Por Ação (LPA).

Nota: Para dados fundamentalistas mais completos, utilize o parâmetro modules.

dividends?boolean

Opcional. Booleano (true ou false). Se true, inclui informações sobre dividendos e JCP (Juros sobre Capital Próprio) pagos historicamente pelo ativo na chave dividendsData.

modules?array<string>

Opcional. Uma lista de módulos de dados adicionais, separados por vírgula (,), para incluir na resposta. Permite buscar dados financeiros detalhados.

Exemplos:

  • modules=summaryProfile (retorna perfil da empresa)
  • modules=balanceSheetHistory,incomeStatementHistory (retorna histórico anual do BP e DRE)

Veja a descrição principal do endpoint para a lista completa de módulos e seus conteúdos.

Response Body

curl -X GET "https://brapi.dev/api/quote/PETR4,MGLU3?token=string&range=5d&interval=1d&fundamental=true&dividends=true&modules=summaryProfile&modules=balanceSheetHistory&modules=financialData"

{
  "results": [
    {
      "currency": "BRL",
      "marketCap": 416355902930,
      "shortName": "PETROBRAS   PN  EDJ N2",
      "longName": "Petróleo Brasileiro S.A. - Petrobras",
      "regularMarketChange": 0.17,
      "regularMarketChangePercent": 0.5499999999999999,
      "regularMarketTime": "2025-08-29T20:07:36.000Z",
      "regularMarketPrice": 31.1,
      "regularMarketDayHigh": 31.35,
      "regularMarketDayRange": "30.85 - 31.35",
      "regularMarketDayLow": 30.85,
      "regularMarketVolume": 27631700,
      "regularMarketPreviousClose": 30.93,
      "regularMarketOpen": 30.54,
      "fiftyTwoWeekRange": "28.86 - 40.76",
      "fiftyTwoWeekLow": 28.86,
      "fiftyTwoWeekHigh": 40.76,
      "symbol": "PETR4",
      "logourl": "https://icons.brapi.dev/icons/PETR4.svg",
      "usedInterval": "1d",
      "usedRange": "5d",
      "historicalDataPrice": [
        {
          "date": 1756126800,
          "open": 30.47,
          "high": 30.78,
          "low": 30.42,
          "close": 30.65,
          "volume": 21075300,
          "adjustedClose": 30.65
        },
        {
          "date": 1756213200,
          "open": 30.48,
          "high": 30.58,
          "low": 30.23,
          "close": 30.43,
          "volume": 21789700,
          "adjustedClose": 30.43
        },
        {
          "date": 1756299600,
          "open": 30.45,
          "high": 30.68,
          "low": 30.36,
          "close": 30.66,
          "volume": 16349100,
          "adjustedClose": 30.66
        },
        {
          "date": 1756386000,
          "open": 30.78,
          "high": 31.13,
          "low": 30.71,
          "close": 30.93,
          "volume": 25802500,
          "adjustedClose": 30.93
        },
        {
          "date": 1756472400,
          "open": 30.93,
          "high": 31.35,
          "low": 30.85,
          "close": 31.1,
          "volume": 27713400,
          "adjustedClose": 31.1
        }
      ],
      "validRanges": [
        "1d",
        "2d",
        "5d",
        "7d",
        "1mo",
        "3mo",
        "6mo",
        "1y",
        "2y",
        "5y",
        "10y",
        "ytd",
        "max"
      ],
      "validIntervals": [
        "1m",
        "2m",
        "5m",
        "15m",
        "30m",
        "60m",
        "90m",
        "1h",
        "1d",
        "5d",
        "1wk",
        "1mo",
        "3mo"
      ],
      "balanceSheetHistory": [
        {
          "symbol": "PETR4",
          "type": "yearly",
          "endDate": "2024-12-31",
          "cash": 20254000000,
          "shortTermInvestments": 26397000000,
          "netReceivables": 22080000000,
          "inventory": 41550000000,
          "otherCurrentAssets": 12756000000,
          "totalCurrentAssets": 135212000000,
          "longTermInvestments": 4081000000,
          "propertyPlantEquipment": 843917000000,
          "otherAssets": 989585000000,
          "totalAssets": 1124797000000,
          "accountsPayable": 37659000000,
          "shortLongTermDebt": 68783000000,
          "otherCurrentLiab": 4418000000,
          "longTermDebt": 304684000000,
          "otherLiab": 3284000000,
          "totalCurrentLiabilities": 194808000000,
          "totalLiab": 1124797000000,
          "commonStock": 205432000000,
          "retainedEarnings": null,
          "treasuryStock": null,
          "otherStockholderEquity": -2457000000,
          "totalStockholderEquity": 367514000000,
          "netTangibleAssets": null,
          "goodWill": null,
          "intangibleAssets": 13961000000,
          "deferredLongTermAssetCharges": null,
          "deferredLongTermLiab": 9100000000,
          "minorityInterest": 1508000000,
          "capitalSurplus": null,
          "taxesToRecover": 12175000000,
          "longTermAssets": 989585000000,
          "longTermRealizableAssets": 127626000000,
          "longTermReceivables": 7777000000,
          "longTermDeferredTaxes": 28011000000,
          "otherNonCurrentAssets": 88233000000,
          "nonCurrentAssets": 1359748000000,
          "provisions": 15501000000,
          "shareholdersEquity": 367514000000,
          "realizedShareCapital": 205432000000,
          "capitalReserves": -2457000000,
          "profitReserves": 95193000000,
          "otherComprehensiveResults": 67838000000,
          "currentLiabilities": 194808000000,
          "socialAndLaborObligations": 9336000000,
          "providers": 37659000000,
          "taxObligations": 8671000000,
          "loansAndFinancing": 68783000000,
          "leaseFinancing": 52896000000,
          "otherObligations": 3256000000,
          "otherCurrentLiabilities": 4418000000,
          "nonCurrentLiabilities": 562475000000,
          "longTermLoansAndFinancing": 304684000000,
          "longTermLeaseFinancing": 177145000000,
          "otherLongTermObligations": 3284000000,
          "longTermProvisions": 245407000000,
          "updatedAt": "2024-12-31"
        }
      ],
      "summaryProfile": {
        "symbol": "PETR4",
        "address1": "Avenida RepUblica do Chile, 65",
        "address2": "Centro",
        "address3": null,
        "city": "Rio De Janeiro",
        "state": "RJ",
        "zip": "20031-912",
        "country": "Brazil",
        "phone": "55 21 96940 2116",
        "fax": null,
        "website": "https://petrobras.com.br",
        "industry": "Oil & Gas Integrated",
        "industryKey": "oil-gas-integrated",
        "industryDisp": "Oil & Gas Integrated",
        "sector": "Energy",
        "sectorKey": "energy",
        "sectorDisp": "Energy",
        "longBusinessSummary": "Petróleo Brasileiro S.A. - Petrobras explores, produces, and sells oil and gas in Brazil and internationally. The company operates through Exploration and Production; Refining, Transportation and Marketing; and Gas and Power. It also engages in prospecting, drilling, refining, processing, trading, and transporting crude oil from producing onshore and offshore oil fields, and shale or other rocks, as well as oil products, natural gas, and other liquid hydrocarbons. The Exploration and Production segment explores, develops, and produces crude oil, natural gas liquids, and natural gas primarily for supplies to the domestic refineries. The Refining, Transportation and Marketing segment engages in the refining, logistics, transport, marketing, and trading of crude oil and oil products; exportation of ethanol; and extraction and processing of shale, as well as holding interests in petrochemical companies. The Gas and Power segment is involved in the logistic and trading of natural gas and electricity; transportation and trading of LNG; generation of electricity through thermoelectric power plants; holding interests in transportation and distribution of natural gas; and fertilizer production and natural gas processing business. In addition, the company produces biodiesel and its co-products, and ethanol; and distributes oil products. Further, it engages in research, development, production, transport, distribution, and trading of energy. Petróleo Brasileiro S.A. - Petrobras was incorporated in 1953 and is headquartered in Rio de Janeiro, Brazil.",
        "fullTimeEmployees": 45149,
        "companyOfficers": [],
        "twitter": null,
        "name": null,
        "startDate": null,
        "description": null,
        "updatedAt": "2024-01-09T23:54:52.487Z"
      },
      "financialData": {
        "symbol": "PETR4",
        "currentPrice": 35.5,
        "ebitda": 204234000000,
        "quickRatio": 0.23947,
        "currentRatio": 0.69408,
        "debtToEquity": 101.6198,
        "revenuePerShare": 38.08202,
        "returnOnAssets": 0.0329,
        "returnOnEquity": 0.1007,
        "earningsGrowth": -0.71767,
        "revenueGrowth": -0.05016,
        "grossMargins": 0.50213,
        "ebitdaMargins": 0.4161,
        "operatingMargins": 0.27953,
        "profitMargins": 0.0754,
        "totalCash": 20254000000,
        "totalCashPerShare": 1.57145,
        "totalDebt": 194808000000,
        "totalRevenue": 490829000000,
        "grossProfits": 246462000000,
        "operatingCashflow": 204037000000,
        "freeCashflow": 131674000000,
        "financialCurrency": "BRL",
        "updatedAt": "2025-03-14",
        "type": "ttm"
      },
      "priceEarnings": 5.180656660725292,
      "earningsPerShare": 6.0030727,
      "dividendsData": {
        "cashDividends": [
          {
            "assetIssued": "BRPETRACNPR6",
            "paymentDate": "2025-02-20T00:00:00.000Z",
            "rate": 0.66,
            "relatedTo": "1º Trimestre/2025",
            "approvedOn": null,
            "isinCode": "BRPETRACNPR6",
            "label": "JCP",
            "lastDatePrior": "2024-12-23T00:00:00.000Z",
            "remarks": ""
          },
          {
            "assetIssued": "BRPETRACNPR6",
            "paymentDate": "2024-12-19T00:00:00.000Z",
            "rate": 0.53,
            "relatedTo": "Dezembro/2024",
            "approvedOn": "2024-08-07T00:00:00.000Z",
            "isinCode": "BRPETRACNPR6",
            "label": "DIVIDENDO",
            "lastDatePrior": "2024-08-20T00:00:00.000Z",
            "remarks": ""
          }
        ],
        "stockDividends": [
          {
            "assetIssued": "BRPETRACNPR6",
            "factor": 2,
            "completeFactor": "2 para 1",
            "approvedOn": "2008-03-24T00:00:00.000Z",
            "isinCode": "BRPETRACNPR6",
            "label": "DESDOBRAMENTO",
            "lastDatePrior": "2008-03-24T00:00:00.000Z",
            "remarks": ""
          }
        ],
        "subscriptions": []
      }
    },
    {
      "currency": "BRL",
      "marketCap": 5470189898,
      "shortName": "MAGAZ LUIZA ON      NM",
      "longName": "Magazine Luiza S.A.",
      "regularMarketChange": 0.35,
      "regularMarketChangePercent": 4.4639999999999995,
      "regularMarketTime": "2025-08-29T20:07:54.000Z",
      "regularMarketPrice": 8.19,
      "regularMarketDayHigh": 8.4,
      "regularMarketDayRange": "7.68 - 8.4",
      "regularMarketDayLow": 7.68,
      "regularMarketVolume": 29307200,
      "regularMarketPreviousClose": 7.84,
      "regularMarketOpen": 6.97,
      "fiftyTwoWeekRange": "5.71 - 12.51",
      "fiftyTwoWeekLow": 5.71,
      "fiftyTwoWeekHigh": 12.51,
      "symbol": "MGLU3",
      "logourl": "https://icons.brapi.dev/icons/MGLU3.svg",
      "usedInterval": "1d",
      "usedRange": "5d",
      "historicalDataPrice": [
        {
          "date": 1756126800,
          "open": 6.96,
          "high": 7.24,
          "low": 6.93,
          "close": 7.12,
          "volume": 15853100,
          "adjustedClose": 7.12
        },
        {
          "date": 1756213200,
          "open": 7.07,
          "high": 7.24,
          "low": 6.98,
          "close": 7,
          "volume": 16124700,
          "adjustedClose": 7
        },
        {
          "date": 1756299600,
          "open": 6.97,
          "high": 7.18,
          "low": 6.88,
          "close": 7.18,
          "volume": 17737000,
          "adjustedClose": 7.18
        },
        {
          "date": 1756386000,
          "open": 7.2,
          "high": 7.97,
          "low": 7.2,
          "close": 7.84,
          "volume": 43622600,
          "adjustedClose": 7.84
        },
        {
          "date": 1756472400,
          "open": 7.77,
          "high": 8.4,
          "low": 7.68,
          "close": 8.19,
          "volume": 29438600,
          "adjustedClose": 8.19
        }
      ],
      "validRanges": [
        "1d",
        "2d",
        "5d",
        "7d",
        "1mo",
        "3mo",
        "6mo",
        "1y",
        "2y",
        "5y",
        "10y",
        "ytd",
        "max"
      ],
      "validIntervals": [
        "1m",
        "2m",
        "5m",
        "15m",
        "30m",
        "60m",
        "90m",
        "1h",
        "1d",
        "5d",
        "1wk",
        "1mo",
        "3mo"
      ],
      "balanceSheetHistory": [
        {
          "symbol": "MGLU3",
          "type": "yearly",
          "endDate": "2024-12-31",
          "cash": 1827197000,
          "shortTermInvestments": 337894000,
          "netReceivables": 5833528000,
          "inventory": 7611132000,
          "otherCurrentAssets": 1986827000,
          "totalCurrentAssets": 19550824000,
          "longTermInvestments": 971862000,
          "propertyPlantEquipment": 5070097000,
          "otherAssets": 17761034000,
          "totalAssets": 37311858000,
          "accountsPayable": 10283119000,
          "shortLongTermDebt": 1402168000,
          "longTermDebt": 3179992000,
          "otherLiab": 3217524000,
          "totalCurrentLiabilities": 16710550000,
          "totalLiab": 37311858000,
          "commonStock": 13602498000,
          "retainedEarnings": null,
          "treasuryStock": null,
          "otherStockholderEquity": -3060268000,
          "totalStockholderEquity": 11319262000,
          "netTangibleAssets": null,
          "goodWill": null,
          "intangibleAssets": 4482287000,
          "deferredLongTermAssetCharges": null,
          "deferredLongTermLiab": 74242000,
          "capitalSurplus": null,
          "taxesToRecover": 1954246000,
          "longTermAssets": 17761034000,
          "longTermRealizableAssets": 7236788000,
          "longTermReceivables": 48553000,
          "longTermDeferredTaxes": 3285792000,
          "shareholdings": 971862000,
          "otherNonCurrentAssets": 3902443000,
          "nonCurrentAssets": 17747007000,
          "shareholdersEquity": 11319262000,
          "realizedShareCapital": 13602498000,
          "capitalReserves": -3060268000,
          "profitReserves": 905996000,
          "otherComprehensiveResults": -128964000,
          "currentLiabilities": 16710550000,
          "socialAndLaborObligations": 558572000,
          "providers": 10283119000,
          "nationalSuppliers": 10283119000,
          "taxObligations": 363003000,
          "loansAndFinancing": 1402168000,
          "otherObligations": 3272073000,
          "nonCurrentLiabilities": 9282046000,
          "longTermLoansAndFinancing": 3179992000,
          "otherLongTermObligations": 3217524000,
          "longTermProvisions": 1857353000,
          "profitsAndRevenuesToBeAppropriated": 952935000,
          "updatedAt": "2024-12-31"
        },
        {
          "symbol": "MGLU3",
          "type": "yearly",
          "endDate": "2023-12-31",
          "cash": 2593346000,
          "shortTermInvestments": 779072000,
          "netReceivables": 5885450000,
          "inventory": 7497299000,
          "otherCurrentAssets": 1608461000,
          "totalCurrentAssets": 20221163000,
          "longTermInvestments": 322516000,
          "propertyPlantEquipment": 5184576000,
          "otherAssets": 17233904000,
          "totalAssets": 37455067000,
          "accountsPayable": 9324072000,
          "shortLongTermDebt": 2954347000,
          "longTermDebt": 4400508000,
          "otherLiab": 3208852000,
          "totalCurrentLiabilities": 17408127000,
          "totalLiab": 37455067000,
          "commonStock": 12352498000,
          "retainedEarnings": null,
          "treasuryStock": null,
          "otherStockholderEquity": -3077861000,
          "totalStockholderEquity": 9610534000,
          "netTangibleAssets": null,
          "goodWill": null,
          "intangibleAssets": 4504807000,
          "deferredLongTermAssetCharges": null,
          "deferredLongTermLiab": 105122000,
          "capitalSurplus": null,
          "taxesToRecover": 1857535000,
          "longTermAssets": 17233904000,
          "longTermRealizableAssets": 7222005000,
          "longTermReceivables": 72691000,
          "longTermDeferredTaxes": 2836852000,
          "shareholdings": 322516000,
          "otherNonCurrentAssets": 4312462000,
          "nonCurrentAssets": 17302182000,
          "shareholdersEquity": 9610534000,
          "realizedShareCapital": 12352498000,
          "capitalReserves": -3077861000,
          "profitReserves": 457279000,
          "otherComprehensiveResults": -121382000,
          "currentLiabilities": 17408127000,
          "socialAndLaborObligations": 401867000,
          "providers": 9324072000,
          "nationalSuppliers": 9324072000,
          "taxObligations": 359971000,
          "loansAndFinancing": 2954347000,
          "otherObligations": 3152706000,
          "nonCurrentLiabilities": 10436406000,
          "longTermLoansAndFinancing": 4400508000,
          "otherLongTermObligations": 3208852000,
          "longTermProvisions": 1619166000,
          "profitsAndRevenuesToBeAppropriated": 1102758000,
          "updatedAt": "2023-12-31"
        }
      ],
      "summaryProfile": {
        "symbol": "MGLU3",
        "address1": "Rua Voluntários da, nº 1.465",
        "address2": "Centro",
        "address3": null,
        "city": "Franca",
        "state": "SP",
        "zip": null,
        "country": "Brazil",
        "phone": null,
        "fax": null,
        "website": "https://www.magazineluiza.com.br",
        "industry": "Specialty Retail",
        "industryKey": "specialty-retail",
        "industryDisp": "Specialty Retail",
        "sector": "Consumer Cyclical",
        "sectorKey": "consumer-cyclical",
        "sectorDisp": "Consumer Cyclical",
        "longBusinessSummary": "Magazine Luiza S.A. engages in the retail sale of consumer goods. It operates through Retail, Financial Operations, Insurance Operations, and Other Services segments. The company also grants credit and provides extended warranties for its products. In addition, it is involved in the provision of consortium management services; and e-commerce of perfumes, cosmetics, sports, and fashion products, as well as product delivery management and software development services. Further, the company provides integration, logistics, and technological solutions; and manages relation between merchants and marketplaces. The company was founded in 1957 and is headquartered in Franca, Brazil. Magazine Luiza S.A. operates as a subsidiary of LTD Administração e Participação S.A.",
        "fullTimeEmployees": null,
        "companyOfficers": [],
        "twitter": null,
        "name": null,
        "startDate": null,
        "description": null,
        "updatedAt": "2024-01-10T01:41:50.950Z"
      },
      "financialData": {
        "symbol": "MGLU3",
        "currentPrice": 9.6,
        "ebitda": 2895720000,
        "quickRatio": 0.12956,
        "currentRatio": 1.16997,
        "debtToEquity": 40.48108,
        "revenuePerShare": 51.47268,
        "returnOnAssets": 0.01203,
        "returnOnEquity": 0.03964,
        "earningsGrowth": 0.42651,
        "revenueGrowth": 0.02278,
        "grossMargins": 0.30567,
        "ebitdaMargins": 0.07613,
        "operatingMargins": 0.04108,
        "profitMargins": 0.0118,
        "totalCash": 1827197000,
        "totalCashPerShare": 2.47254,
        "totalDebt": 16710550000,
        "totalRevenue": 38038068000,
        "grossProfits": 11627256000,
        "operatingCashflow": 15835331000,
        "freeCashflow": 14544725000,
        "financialCurrency": "BRL",
        "updatedAt": "2025-03-14",
        "type": "ttm"
      },
      "priceEarnings": 15.656662206079142,
      "earningsPerShare": 0.5238851,
      "dividendsData": {
        "cashDividends": [
          {
            "assetIssued": "BRMGLUACNOR2",
            "paymentDate": "2022-05-06T00:00:00.000Z",
            "rate": 0.02,
            "relatedTo": "2º Trimestre/2022",
            "approvedOn": "2022-04-26T00:00:00.000Z",
            "isinCode": "BRMGLUACNOR2",
            "label": "JCP",
            "lastDatePrior": "2021-07-05T00:00:00.000Z",
            "remarks": ""
          },
          {
            "assetIssued": "BRMGLUACNOR2",
            "paymentDate": "2022-05-05T00:00:00.000Z",
            "rate": 0.02,
            "relatedTo": "2º Trimestre/2022",
            "approvedOn": "2021-06-29T00:00:00.000Z",
            "isinCode": "BRMGLUACNOR2",
            "label": "JCP",
            "lastDatePrior": "2021-07-04T00:00:00.000Z",
            "remarks": ""
          }
        ],
        "stockDividends": [
          {
            "assetIssued": "BRMGLUACNOR2",
            "factor": 0.1,
            "completeFactor": "1 para 10",
            "approvedOn": "2024-05-27T00:00:00.000Z",
            "isinCode": "BRMGLUACNOR2",
            "label": "GRUPAMENTO",
            "lastDatePrior": "2024-05-27T00:00:00.000Z",
            "remarks": ""
          }
        ],
        "subscriptions": []
      }
    }
  ],
  "requestedAt": "2025-08-30T15:53:07.499Z",
  "took": "0ms"
}

{
  "error": true,
  "message": "Campo 'range' inválido. Ranges válidos: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max"
}

{
  "error": true,
  "message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}

{
  "error": true,
  "message": "Você atingiu o limite de requisições para o seu plano. Por favor, considere fazer um upgrade para um plano melhor em brapi.dev/dashboard"
}

{
  "error": true,
  "message": "Não encontramos a ação G3X"
}

Exemplos

Exemplos de uso da brapi

Cotação de todas as açõesGET

Cotação de todas as ações disponíveis na brapi