# Cotação, Dividendos e Dados Financeiros URL: /docs/acoes.mdx 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. *** title: Cotação, Dividendos e Dados Financeiros description: >- 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. full: true keywords: brapi, api, documentação, ações openGraph: title: Cotação, Dividendos e Dados Financeiros description: >- 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. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.251Z' lang: pt-BR \_openapi: method: GET route: /api/quote/{tickers} toc: * depth: 2 title: Dados de Ações e Ativos Financeiros url: '#buscar-cotação-detalhada-de-ativos-financeiros' structuredData: headings: * content: Dados de Ações e Ativos Financeiros id: buscar-cotação-detalhada-de-ativos-financeiros contents: * content: > 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). ### Autenticação: É **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:** ```bash curl -X GET "https://brapi.dev/api/quote/PETR4,VALE3?token=SEU_TOKEN" ``` **2. Cotação de MGLU3 com dados históricos do último mês (intervalo diário):** ```bash curl -X GET "https://brapi.dev/api/quote/MGLU3?range=1mo&interval=1d&token=SEU_TOKEN" ``` **3. Cotação de ITSA4 incluindo dividendos e dados fundamentalistas básicos:** ```bash curl -X GET "https://brapi.dev/api/quote/ITSA4?fundamental=true÷nds=true&token=SEU_TOKEN" ``` **4. Cotação de WEGE3 com Resumo da Empresa e Balanço Patrimonial Anual (via módulos):** ```bash curl -X GET "https://brapi.dev/api/quote/WEGE3?modules=summaryProfile,balanceSheetHistory&token=SEU_TOKEN" ``` ### 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: ```bash 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. heading: buscar-cotação-detalhada-de-ativos-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. ## Swagger Documentation # Brapi - API do Mercado Financeiro Brasileiro - /api/quote/{tickers} Single endpoint documentation for /api/quote/{tickers} ## Base URLs - `https://brapi.dev` - Servidor principal da API Brapi - `http://localhost:3000` - Servidor local para desenvolvimento ## GET /api/quote/{tickers} **Summary:** 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). ### Autenticação: É **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:** ```bash curl -X GET "https://brapi.dev/api/quote/PETR4,VALE3?token=SEU_TOKEN" ``` **2. Cotação de MGLU3 com dados históricos do último mês (intervalo diário):** ```bash curl -X GET "https://brapi.dev/api/quote/MGLU3?range=1mo&interval=1d&token=SEU_TOKEN" ``` **3. Cotação de ITSA4 incluindo dividendos e dados fundamentalistas básicos:** ```bash curl -X GET "https://brapi.dev/api/quote/ITSA4?fundamental=true÷nds=true&token=SEU_TOKEN" ``` **4. Cotação de WEGE3 com Resumo da Empresa e Balanço Patrimonial Anual (via módulos):** ```bash curl -X GET "https://brapi.dev/api/quote/WEGE3?modules=summaryProfile,balanceSheetHistory&token=SEU_TOKEN" ``` ### 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: ```bash 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. **Tags:** Ações ### Parameters - **tickers** (path) *required*: **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). - **undefined** (undefined) - **range** (query): **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. - **interval** (query): **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. - **fundamental** (query): **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** (query): **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** (query): **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. ### Responses #### 200 **Sucesso.** A requisição foi bem-sucedida e os dados dos ativos solicitados foram retornados. A estrutura da resposta inclui um array `results` com os detalhes de cada ativo. **Example Response:** ```json { "results": [ { "symbol": "PETR4", "currency": "BRL", "twoHundredDayAverage": 29.55485, "twoHundredDayAverageChange": 7.1551495, "twoHundredDayAverageChangePercent": 0.2420973, "marketCap": 497695817728, "shortName": "PETROBRAS PN N2", "longName": "Petróleo Brasileiro S.A. - Petrobras", "regularMarketChange": 1.1599998, "regularMarketChangePercent": 3.2630093, "regularMarketTime": "2023-11-17T21:07:47.000Z", "regularMarketPrice": 36.71, "regularMarketDayHigh": 36.82, "regularMarketDayRange": "35.51 - 36.82", "regularMarketDayLow": 35.51, "regularMarketVolume": 87666300, "regularMarketPreviousClose": 35.55, "regularMarketOpen": 35.83, "averageDailyVolume3Month": 49987483, "averageDailyVolume10Day": 54835377, "fiftyTwoWeekLowChange": 36.71, "fiftyTwoWeekRange": "32.21 - 38.86", "fiftyTwoWeekHighChange": -2.1500015, "fiftyTwoWeekHighChangePercent": -0.055326853, "fiftyTwoWeekLow": 32.21, "fiftyTwoWeekHigh": 38.86, "priceEarnings": 3.49722289, "earningsPerShare": 10.4968915, "logourl": "https://icons.brapi.dev/icons/PETR4.svg", "usedInterval": "1d", "usedRange": "5d", "historicalDataPrice": [ { "date": 1699621200, "open": 34.66, "high": 35.06, "low": 34.51, "close": 34.72, "volume": 40004800, "adjustedClose": 34.72 } ], "validRanges": [ "1d", "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": [ { "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 } ], "dividendsData": { "cashDividends": [ { "assetIssued": "BRPETRACNPR6", "paymentDate": "2023-11-22T13:00:00.000Z", "rate": 1.345348, "relatedTo": "4º Trimestre/2023", "approvedOn": "2023-11-22T13:00:00.000Z", "isinCode": "BRPETRACNPR6", "label": "DIVIDENDO", "lastDatePrior": "2023-11-22T13:00:00.000Z", "remarks": "" } ], "stockDividends": [], "subscriptions": [] } }, { "symbol": "^BVSP", "currency": "BRL", "twoHundredDayAverage": 111633.99, "twoHundredDayAverageChange": 3522.0781, "twoHundredDayAverageChangePercent": 0.03155023, "marketCap": null, "shortName": "IBOVESPA", "longName": "IBOVESPA", "regularMarketChange": 986.4375, "regularMarketChangePercent": 0.8640104, "regularMarketTime": "2023-10-09T20:19:00.000Z", "regularMarketPrice": 115156.07, "regularMarketDayHigh": 115218.65, "regularMarketDayRange": "113448.18 - 115218.65", "regularMarketDayLow": 113448.18, "regularMarketVolume": 0, "regularMarketPreviousClose": 114169.63, "regularMarketOpen": 114168.99, "averageDailyVolume3Month": 10704804, "averageDailyVolume10Day": 10880020, "fiftyTwoWeekLowChange": 18159.07, "fiftyTwoWeekLowChangePercent": 0.1872127, "fiftyTwoWeekRange": "96997.0 - 123010.0", "fiftyTwoWeekHighChange": -7853.9297, "fiftyTwoWeekHighChangePercent": -0.0638479, "fiftyTwoWeekLow": 96997, "fiftyTwoWeekHigh": 123010, "priceEarnings": null, "earningsPerShare": null, "logourl": "https://brapi.dev/favicon.svg", "updatedAt": "2023-10-10T00:45:08.312Z", "historicalDataPrice": [ { "date": 1696338000, "open": 115055, "high": 115056, "low": 113151, "close": 113419, "volume": 11104800, "adjustedClose": 113419 } ], "validRanges": [ "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max" ], "validIntervals": [ "1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo" ], "dividendsData": {} } ], "requestedAt": "2023-11-19T23:55:24.958Z", "took": "746ms" } ``` #### 400 **Bad Request.** A requisição foi malformada ou continha parâmetros inválidos. Verifique a sintaxe dos tickers e os valores dos parâmetros `range`, `interval`, `fundamental`, `dividends` e `modules`. **Example Response:** ```json { "error": true, "message": "Campo 'range' inválido. Ranges válidos: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max" } ``` #### 401 #### 402 **Payment Required.** O limite de requisições associado ao seu token/plano foi atingido. Considere um upgrade ou aguarde a renovação do limite. **Example Response:** ```json { "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" } ``` #### 404 **Not Found.** Um ou mais tickers informados no path não correspondem a nenhum ativo conhecido pela API. **Example Response:** ```json { "error": true, "message": "Não encontramos a ação G3X" } ``` ## Schemas The following schemas are used by this endpoint: ### BalanceSheetEntry Representa os dados de um Balanço Patrimonial para um período específico (anual ou trimestral). **Properties:** - **type** (string) - Options: `yearly`, `quarterly` Indica a periodicidade do balanço: `yearly` (anual) ou `quarterly` (trimestral). - **endDate** (string, date) Data de término do período fiscal ao qual o balanço se refere (YYYY-MM-DD). - **cash** (number, int64) *(nullable)* Caixa e Equivalentes de Caixa. - **shortTermInvestments** (number, int64) *(nullable)* Aplicações Financeiras de Curto Prazo. - **netReceivables** (number, int64) *(nullable)* Contas a Receber Líquidas (Clientes). - **inventory** (number, int64) *(nullable)* Estoques. - **otherCurrentAssets** (number, int64) *(nullable)* Outros Ativos Circulantes. - **totalCurrentAssets** (number, int64) *(nullable)* Total do Ativo Circulante. - **longTermInvestments** (number, int64) *(nullable)* Investimentos de Longo Prazo. - **propertyPlantEquipment** (number, int64) *(nullable)* Imobilizado (Propriedades, Instalações e Equipamentos). - **otherAssets** (number, int64) *(nullable)* Outros Ativos Não Circulantes. - **totalAssets** (number, int64) *(nullable)* Total do Ativo. - **accountsPayable** (number, int64) *(nullable)* Contas a Pagar (Fornecedores). - **shortLongTermDebt** (number, int64) *(nullable)* Dívida de Curto Prazo (Empréstimos e Financiamentos Circulantes). - **otherCurrentLiab** (number, int64) *(nullable)* Outros Passivos Circulantes. - **longTermDebt** (number, int64) *(nullable)* Dívida de Longo Prazo (Empréstimos e Financiamentos Não Circulantes). - **otherLiab** (number, int64) *(nullable)* Outros Passivos Não Circulantes. - **totalCurrentLiabilities** (number, int64) *(nullable)* Total do Passivo Circulante. - **totalLiab** (number, int64) *(nullable)* Total do Passivo (Circulante + Não Circulante). - **commonStock** (number, int64) *(nullable)* Capital Social Realizado. - **retainedEarnings** (number, int64) *(nullable)* Lucros/Prejuízos Acumulados. - **treasuryStock** (number, int64) *(nullable)* Ações em Tesouraria. - **otherStockholderEquity** (number, int64) *(nullable)* Outros Componentes do Patrimônio Líquido (ex: Ajustes de Avaliação Patrimonial). - **totalStockholderEquity** (number, int64) *(nullable)* Total do Patrimônio Líquido. - **netTangibleAssets** (number, int64) *(nullable)* Ativos Tangíveis Líquidos (Ativo Total - Ativos Intangíveis - Passivo Total). Campo menos comum em padrões BR. - **goodWill** (number, int64) *(nullable)* Ágio por Expectativa de Rentabilidade Futura (Goodwill). - **intangibleAssets** (number, int64) *(nullable)* Ativos Intangíveis (Marcas, Patentes, etc.). - **deferredLongTermAssetCharges** (number, int64) *(nullable)* Encargos Diferidos de Ativos de Longo Prazo (menos comum). - **deferredLongTermLiab** (number, int64) *(nullable)* Passivos Fiscais Diferidos (Longo Prazo). - **minorityInterest** (number, int64) *(nullable)* Participação de Acionistas Não Controladores (no Patrimônio Líquido). - **capitalSurplus** (number, int64) *(nullable)* Reservas de Capital (Ágio na Emissão de Ações, etc.). - **taxesToRecover** (number, int64) *(nullable)* Impostos a Recuperar (Ativo Circulante ou Não Circulante). - **longTermAssets** (number, int64) *(nullable)* Total do Ativo Não Circulante (Agregado). - **longTermRealizableAssets** (number, int64) *(nullable)* Ativo Realizável a Longo Prazo. - **longTermReceivables** (number, int64) *(nullable)* Contas a Receber de Longo Prazo. - **longTermDeferredTaxes** (number, int64) *(nullable)* Tributos Diferidos (Ativo Não Circulante). - **otherNonCurrentAssets** (number, int64) *(nullable)* Outros Ativos Não Circulantes (detalhamento específico do BP). - **nonCurrentAssets** (number, int64) *(nullable)* Total do Ativo Não Circulante (sinônimo de `longTermAssets` dependendo da fonte). - **provisions** (number, int64) *(nullable)* Provisões (Passivo Circulante ou Não Circulante). - **shareholdersEquity** (number, int64) *(nullable)* Patrimônio Líquido (sinônimo de `totalStockholderEquity`). - **realizedShareCapital** (number, int64) *(nullable)* Capital Social Realizado (sinônimo de `commonStock`). - **capitalReserves** (number, int64) *(nullable)* Reservas de Capital (sinônimo de `capitalSurplus`). - **profitReserves** (number, int64) *(nullable)* Reservas de Lucros. - **otherComprehensiveResults** (number, int64) *(nullable)* Outros Resultados Abrangentes (sinônimo de `otherStockholderEquity`). - **currentLiabilities** (number, int64) *(nullable)* Total do Passivo Circulante (sinônimo de `totalCurrentLiabilities`). - **socialAndLaborObligations** (number, int64) *(nullable)* Obrigações Sociais e Trabalhistas (Passivo Circulante). - **providers** (number, int64) *(nullable)* Fornecedores (sinônimo de `accountsPayable`). - **taxObligations** (number, int64) *(nullable)* Obrigações Fiscais (Passivo Circulante). - **loansAndFinancing** (number, int64) *(nullable)* Empréstimos e Financiamentos (Circulante - sinônimo de `shortLongTermDebt`). - **leaseFinancing** (number, int64) *(nullable)* Financiamento por Arrendamento Mercantil (Passivo Circulante). - **otherObligations** (number, int64) *(nullable)* Outras Obrigações (Passivo Circulante). - **otherCurrentLiabilities** (number, int64) *(nullable)* Outros Passivos Circulantes (sinônimo de `otherCurrentLiab`). - **nonCurrentLiabilities** (number, int64) *(nullable)* Total do Passivo Não Circulante. - **longTermLoansAndFinancing** (number, int64) *(nullable)* Empréstimos e Financiamentos (Não Circulante - sinônimo de `longTermDebt`). - **longTermLeaseFinancing** (number, int64) *(nullable)* Financiamento por Arrendamento Mercantil (Passivo Não Circulante). - **otherLongTermObligations** (number, int64) *(nullable)* Outras Obrigações (Passivo Não Circulante - sinônimo de `otherLiab`). - **longTermProvisions** (number, int64) *(nullable)* Provisões (Passivo Não Circulante). - **updatedAt** (string, date) *(nullable)* Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD). ### CashDividend Detalhes sobre um pagamento de provento em dinheiro (Dividendo ou JCP). **Properties:** - **assetIssued** (string) Ticker do ativo que pagou o provento (ex: `ITSA4`). Pode incluir sufixos específicos relacionados ao evento. - **paymentDate** (string, date-time) *(nullable)* Data efetiva em que o pagamento foi realizado (ou está previsto). Formato ISO 8601. - **rate** (number, float) Valor bruto do provento pago por unidade do ativo (por ação, por cota). - **relatedTo** (string) *(nullable)* Descrição do período ou evento ao qual o provento se refere (ex: `1º Trimestre/2023`, `Resultado 2022`). - **approvedOn** (string, date-time) Data em que o pagamento do provento foi aprovado pela empresa. Pode ser uma estimativa em alguns casos. Formato ISO 8601. - **isinCode** (string) *(nullable)* Código ISIN (International Securities Identification Number) do ativo relacionado ao provento. - **label** (string) Tipo do provento em dinheiro. Geralmente `DIVIDENDO` ou `JCP` (Juros sobre Capital Próprio). - **lastDatePrior** (string, date-time) Data Com (Ex-Date). Último dia em que era necessário possuir o ativo para ter direito a receber este provento. Pode ser uma estimativa. Formato ISO 8601. - **remarks** (string) *(nullable)* Observações adicionais ou informações relevantes sobre o provento. ### CashflowEntry Representa os dados de uma Demonstração do Fluxo de Caixa (DFC) para um período específico (anual ou trimestral). **Properties:** - **symbol** (string) Ticker do ativo ao qual a DFC se refere. - **type** (string) - Options: `yearly`, `quarterly` Indica a periodicidade da DFC: `yearly` (anual) ou `quarterly` (trimestral). - **endDate** (string, date) Data de término do período fiscal ao qual a DFC se refere (YYYY-MM-DD). - **operatingCashFlow** (number, int64) *(nullable)* Fluxo de Caixa das Atividades Operacionais (FCO). - **incomeFromOperations** (number, int64) *(nullable)* Caixa Gerado nas Operações (antes das variações de ativos/passivos). - **changesInAssetsAndLiabilities** (number, int64) *(nullable)* Variações em Ativos e Passivos Operacionais (Clientes, Estoques, Fornecedores, etc.). - **otherOperatingActivities** (number, int64) *(nullable)* Outras Atividades Operacionais (Juros pagos/recebidos, Impostos pagos, etc.). - **investmentCashFlow** (number, int64) *(nullable)* Fluxo de Caixa das Atividades de Investimento (FCI) (Compra/Venda de Imobilizado, Investimentos). - **financingCashFlow** (number, int64) *(nullable)* Fluxo de Caixa das Atividades de Financiamento (FCF) (Captação/Pagamento de Empréstimos, Emissão/Recompra de Ações, Dividendos pagos). - **foreignExchangeRateWithoutCash** (number, int64) *(nullable)* Efeito da Variação Cambial sobre o Caixa e Equivalentes. - **increaseOrDecreaseInCash** (number, int64) *(nullable)* Aumento ou Redução Líquida de Caixa e Equivalentes (FCO + FCI + FCF + Variação Cambial). - **initialCashBalance** (number, int64) *(nullable)* Saldo Inicial de Caixa e Equivalentes no início do período. - **finalCashBalance** (number, int64) *(nullable)* Saldo Final de Caixa e Equivalentes no final do período. - **updatedAt** (string, date) Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD). ### DefaultKeyStatisticsEntry Representa um conjunto de principais indicadores e estatísticas financeiras para um período (TTM, anual ou trimestral). **Properties:** - **type** (string) - Options: `yearly`, `quarterly`, `ttm` Periodicidade dos dados: `yearly` (anual), `quarterly` (trimestral), `ttm` (Trailing Twelve Months - últimos 12 meses). - **symbol** (string) Ticker do ativo ao qual as estatísticas se referem. - **enterpriseValue** (number, float) *(nullable)* Valor da Firma (Enterprise Value - EV): Market Cap + Dívida Total - Caixa. - **forwardPE** (number, float) *(nullable)* Preço / Lucro Projetado (Forward P/E): Preço da Ação / LPA estimado para o próximo período. - **profitMargins** (number, float) *(nullable)* Margem de Lucro Líquida (Lucro Líquido / Receita Líquida). Geralmente em base TTM ou anual. - **sharesOutstanding** (number, int64) *(nullable)* Número total de ações ordinárias em circulação. - **bookValue** (number, float) *(nullable)* Valor Patrimonial por Ação (VPA): Patrimônio Líquido / Ações em Circulação. - **priceToBook** (number, float) *(nullable)* Preço sobre Valor Patrimonial (P/VP): Preço da Ação / VPA. - **mostRecentQuarter** (string, date) *(nullable)* Data de término do trimestre mais recente considerado nos cálculos (YYYY-MM-DD). - **earningsQuarterlyGrowth** (number, float) *(nullable)* Crescimento percentual do lucro líquido no último trimestre em relação ao mesmo trimestre do ano anterior (YoY). - **earningsAnnualGrowth** (number, float) *(nullable)* Crescimento percentual do lucro líquido no último ano fiscal completo em relação ao ano anterior. - **trailingEps** (number, float) *(nullable)* Lucro Por Ação (LPA) dos Últimos 12 Meses (TTM). - **enterpriseToRevenue** (number, float) *(nullable)* Múltiplo EV/Receita (Enterprise Value / Receita Líquida TTM). - **enterpriseToEbitda** (number, float) *(nullable)* Múltiplo EV/EBITDA (Enterprise Value / EBITDA TTM). - **52WeekChange** (number, float) *(nullable)* Variação percentual do preço da ação nas últimas 52 semanas. - **lastDividendValue** (number, float) *(nullable)* Valor do último dividendo ou JCP pago por ação. - **lastDividendDate** (string, date) *(nullable)* Data de pagamento (ou 'Data Com') do último dividendo/JCP (YYYY-MM-DD). - **ytdReturn** (number, float) *(nullable)* Retorno percentual do preço da ação desde o início do ano atual (Year-to-Date). - **totalAssets** (number, int64) *(nullable)* Valor total dos ativos registrado no último balanço (anual ou trimestral). - **updatedAt** (string, date) *(nullable)* Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD). ### DividendsData Agrupa informações sobre proventos e eventos corporativos. Retornado quando `dividends=true` é solicitado. **Properties:** - **cashDividends** (array) Lista de proventos pagos em dinheiro (Dividendos e JCP). Array items: Reference to: **CashDividend** - **stockDividends** (array) Lista de eventos corporativos (Desdobramento, Grupamento, Bonificação). Array items: Reference to: **StockDividend** - **subscriptions** (array) Lista de eventos de subscrição de ações (estrutura não detalhada aqui). Array items: ### ErrorResponse Schema padrão para respostas de erro da API. **Properties:** - **error** (boolean) *(required)* Indica se a requisição resultou em erro. Sempre `true` para este schema. - **message** (string) *(required)* Mensagem descritiva do erro ocorrido. ### FinancialDataEntry Representa um conjunto de dados e indicadores financeiros calculados para um período (TTM, anual ou trimestral). **Properties:** - **symbol** (string) Ticker do ativo ao qual os dados se referem. - **currentPrice** (number, float) *(nullable)* Preço atual da ação (pode ser ligeiramente defasado). - **ebitda** (number, int64) *(nullable)* Lucro Antes de Juros, Impostos, Depreciação e Amortização (LAJIDA ou EBITDA). Geralmente TTM. - **quickRatio** (number, float) *(nullable)* Índice de Liquidez Seca ((Ativo Circulante - Estoques) / Passivo Circulante). - **currentRatio** (number, float) *(nullable)* Índice de Liquidez Corrente (Ativo Circulante / Passivo Circulante). - **debtToEquity** (number, float) *(nullable)* Índice Dívida Líquida / Patrimônio Líquido. - **revenuePerShare** (number, float) *(nullable)* Receita Líquida por Ação (Receita Líquida TTM / Ações em Circulação). - **returnOnAssets** (number, float) *(nullable)* Retorno sobre Ativos (ROA): Lucro Líquido TTM / Ativo Total Médio. - **returnOnEquity** (number, float) *(nullable)* Retorno sobre Patrimônio Líquido (ROE): Lucro Líquido TTM / Patrimônio Líquido Médio. - **earningsGrowth** (number, float) *(nullable)* Crescimento do Lucro Líquido (geralmente trimestral YoY, como `earningsQuarterlyGrowth`). - **revenueGrowth** (number, float) *(nullable)* Crescimento da Receita Líquida (geralmente trimestral YoY). - **grossMargins** (number, float) *(nullable)* Margem Bruta (Lucro Bruto TTM / Receita Líquida TTM). - **ebitdaMargins** (number, float) *(nullable)* Margem EBITDA (EBITDA TTM / Receita Líquida TTM). - **operatingMargins** (number, float) *(nullable)* Margem Operacional (EBIT TTM / Receita Líquida TTM). - **profitMargins** (number, float) *(nullable)* Margem Líquida (Lucro Líquido TTM / Receita Líquida TTM). Sinônimo do campo de mesmo nome em `DefaultKeyStatisticsEntry`. - **totalCash** (number, int64) *(nullable)* Caixa e Equivalentes de Caixa + Aplicações Financeiras de Curto Prazo (último balanço). - **totalCashPerShare** (number, float) *(nullable)* Caixa Total por Ação (Caixa Total / Ações em Circulação). - **totalDebt** (number, int64) *(nullable)* Dívida Bruta Total (Dívida de Curto Prazo + Dívida de Longo Prazo - último balanço). - **totalRevenue** (number, int64) *(nullable)* Receita Líquida Total (geralmente TTM). - **grossProfits** (number, int64) *(nullable)* Lucro Bruto (geralmente TTM). - **operatingCashflow** (number, int64) *(nullable)* Fluxo de Caixa das Operações (FCO) - (geralmente TTM). - **freeCashflow** (number, int64) *(nullable)* Fluxo de Caixa Livre (FCO - CAPEX) - (geralmente TTM). - **financialCurrency** (string) *(nullable)* Moeda na qual os dados financeiros são reportados (ex: `BRL`, `USD`). - **updatedAt** (string, date) Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD). - **type** (string) - Options: `yearly`, `quarterly`, `ttm` Periodicidade dos dados: `yearly` (anual), `quarterly` (trimestral), `ttm` (Trailing Twelve Months). ### HistoricalDataPrice Representa um ponto na série histórica de preços de um ativo. **Properties:** - **date** (integer, int64) 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, float) Preço de abertura do ativo no intervalo (dia, semana, mês, etc.). - **high** (number, float) Preço máximo atingido pelo ativo no intervalo. - **low** (number, float) Preço mínimo atingido pelo ativo no intervalo. - **close** (number, float) Preço de fechamento do ativo no intervalo. - **volume** (integer, int64) Volume financeiro negociado no intervalo. - **adjustedClose** (number, float) Preço de fechamento ajustado para proventos (dividendos, JCP, bonificações, etc.) e desdobramentos/grupamentos. ### IncomeStatementEntry Representa os dados de uma Demonstração do Resultado do Exercício (DRE) para um período específico (anual ou trimestral). **Properties:** - **type** (string) - Options: `yearly`, `quarterly` Indica a periodicidade da DRE: `yearly` (anual) ou `quarterly` (trimestral). - **endDate** (string, date) Data de término do período fiscal ao qual a DRE se refere (YYYY-MM-DD). - **totalRevenue** (number, int64) *(nullable)* Receita Operacional Líquida. - **costOfRevenue** (number, int64) *(nullable)* Custo dos Produtos Vendidos (CPV) ou Custo dos Serviços Prestados (CSP). - **grossProfit** (number, int64) *(nullable)* Lucro Bruto (Receita Líquida - CPV/CSP). - **researchDevelopment** (number, int64) *(nullable)* Despesas com Pesquisa e Desenvolvimento. - **sellingGeneralAdministrative** (number, int64) *(nullable)* Despesas com Vendas, Gerais e Administrativas. - **nonRecurring** (number, int64) *(nullable)* Itens Não Recorrentes (pode incluir outras despesas/receitas operacionais). - **otherOperatingExpenses** (number, int64) *(nullable)* Outras Despesas Operacionais. - **totalOperatingExpenses** (number, int64) *(nullable)* Total das Despesas Operacionais (P&D + SG&A + Outras). - **operatingIncome** (number, int64) *(nullable)* Lucro Operacional (EBIT - Earnings Before Interest and Taxes). Lucro Bruto - Despesas Operacionais. - **totalOtherIncomeExpenseNet** (number, int64) *(nullable)* Resultado Financeiro Líquido + Outras Receitas/Despesas. - **ebit** (number, int64) *(nullable)* Lucro Antes dos Juros e Impostos (LAJIR ou EBIT). Geralmente igual a `operatingIncome`. - **interestExpense** (number, int64) *(nullable)* Despesas Financeiras (Juros pagos). Note que este campo é negativo. - **incomeBeforeTax** (number, int64) *(nullable)* Lucro Antes do Imposto de Renda e Contribuição Social (LAIR). EBIT + Resultado Financeiro. - **incomeTaxExpense** (number, int64) *(nullable)* Imposto de Renda e Contribuição Social sobre o Lucro. - **minorityInterest** (number, int64) *(nullable)* Participação de Acionistas Não Controladores (no Lucro Líquido). - **netIncomeFromContinuingOps** (number, int64) *(nullable)* Lucro Líquido das Operações Continuadas. - **discontinuedOperations** (number, int64) *(nullable)* Resultado Líquido das Operações Descontinuadas. - **extraordinaryItems** (number, int64) *(nullable)* Itens Extraordinários. - **effectOfAccountingCharges** (number, int64) *(nullable)* Efeito de Mudanças Contábeis. - **otherItems** (number, int64) *(nullable)* Outros Itens. - **netIncome** (number, int64) *(nullable)* Lucro Líquido Consolidado do Período. - **netIncomeApplicableToCommonShares** (number, int64) *(nullable)* Lucro Líquido Atribuível aos Acionistas Controladores (Ações Ordinárias). - **salesExpenses** (number, int64) *(nullable)* Despesas com Vendas (detalhamento, pode estar contido em SG&A). - **lossesDueToNonRecoverabilityOfAssets** (number, int64) *(nullable)* Perdas por Não Recuperabilidade de Ativos (Impairment). - **otherOperatingIncome** (number, int64) *(nullable)* Outras Receitas Operacionais (detalhamento). - **equityIncomeResult** (number, int64) *(nullable)* Resultado de Equivalência Patrimonial. - **financialResult** (number, int64) *(nullable)* Resultado Financeiro Líquido. - **financialIncome** (number, int64) *(nullable)* Receitas Financeiras. - **financialExpenses** (number, int64) *(nullable)* Despesas Financeiras (valor positivo aqui, diferente de `interestExpense`). - **currentTaxes** (number, int64) *(nullable)* Imposto de Renda e Contribuição Social Correntes. - **deferredTaxes** (number, int64) *(nullable)* Imposto de Renda e Contribuição Social Diferidos. - **incomeBeforeStatutoryParticipationsAndContributions** (number, int64) *(nullable)* Resultado Antes das Participações Estatutárias. - **basicEarningsPerCommonShare** (number, float) *(nullable)* Lucro Básico por Ação Ordinária (ON). - **dilutedEarningsPerCommonShare** (number, float) *(nullable)* Lucro Diluído por Ação Ordinária (ON). - **basicEarningsPerPreferredShare** (number, float) *(nullable)* Lucro Básico por Ação Preferencial (PN). - **profitSharingAndStatutoryContributions** (number, int64) *(nullable)* Participações nos Lucros e Contribuições Estatutárias. - **dilutedEarningsPerPreferredShare** (number, float) *(nullable)* Lucro Diluído por Ação Preferencial (PN). - **claimsAndOperationsCosts** (number, int64) *(nullable)* Custos com Sinistros e Operações (específico para Seguradoras). - **administrativeCosts** (number, int64) *(nullable)* Despesas Administrativas (detalhamento, pode estar contido em SG&A). - **otherOperatingIncomeAndExpenses** (number, int64) *(nullable)* Outras Receitas e Despesas Operacionais (agregado). - **earningsPerShare** (number, float) *(nullable)* Lucro por Ação (LPA) - Geral (pode ser básico ou diluído, verificar contexto). - **basicEarningsPerShare** (number, float) *(nullable)* Lucro Básico por Ação (LPA Básico) - Geral. - **dilutedEarningsPerShare** (number, float) *(nullable)* Lucro Diluído por Ação (LPA Diluído) - Geral. - **insuranceOperations** (number, int64) *(nullable)* Resultado de Operações de Seguros (específico para Seguradoras). - **reinsuranceOperations** (number, int64) *(nullable)* Resultado de Operações de Resseguros (específico para Seguradoras). - **complementaryPensionOperations** (number, int64) *(nullable)* Resultado de Operações de Previdência Complementar (específico para Seguradoras/Previdência). - **capitalizationOperations** (number, int64) *(nullable)* Resultado de Operações de Capitalização (específico para Seguradoras). - **updatedAt** (string, date) Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD). ### QuoteResponse Resposta principal do endpoint `/api/quote/{tickers}`. **Properties:** - **results** (array) Array contendo os resultados detalhados para cada ticker solicitado. Array items: Reference to: **QuoteResult** - **requestedAt** (string, date-time) Timestamp indicando quando a requisição foi recebida pelo servidor. Formato ISO 8601. - **took** (string) Tempo aproximado que o servidor levou para processar a requisição, em formato de string (ex: `746ms`). ### QuoteResult Contém os dados detalhados de um ativo específico retornado pelo endpoint `/api/quote/{tickers}`. **Properties:** - **symbol** (string) Ticker (símbolo) do ativo (ex: `PETR4`, `^BVSP`). - **currency** (string) Moeda na qual os valores monetários são expressos (geralmente `BRL`). - **twoHundredDayAverage** (number, float) *(nullable)* Média móvel simples dos preços de fechamento dos últimos 200 dias. - **twoHundredDayAverageChange** (number, float) *(nullable)* Variação absoluta entre o preço atual e a média de 200 dias. - **twoHundredDayAverageChangePercent** (number, float) *(nullable)* Variação percentual entre o preço atual e a média de 200 dias. - **marketCap** (number, int64) *(nullable)* Capitalização de mercado total do ativo (Preço Atual x Ações em Circulação). - **shortName** (string) *(nullable)* Nome curto ou abreviado da empresa ou ativo. - **longName** (string) *(nullable)* Nome longo ou completo da empresa ou ativo. - **regularMarketChange** (number, float) *(nullable)* Variação absoluta do preço no dia atual em relação ao fechamento anterior. - **regularMarketChangePercent** (number, float) *(nullable)* Variação percentual do preço no dia atual em relação ao fechamento anterior. - **regularMarketTime** (string, date-time) *(nullable)* Data e hora da última atualização da cotação (último negócio registrado). Formato ISO 8601. - **regularMarketPrice** (number, float) *(nullable)* Preço atual ou do último negócio registrado. - **regularMarketDayHigh** (number, float) *(nullable)* Preço máximo atingido no dia de negociação atual. - **regularMarketDayRange** (string) *(nullable)* String formatada mostrando o intervalo de preço do dia (Mínimo - Máximo). - **regularMarketDayLow** (number, float) *(nullable)* Preço mínimo atingido no dia de negociação atual. - **regularMarketVolume** (number, int64) *(nullable)* Volume financeiro negociado no dia atual. - **regularMarketPreviousClose** (number, float) *(nullable)* Preço de fechamento do pregão anterior. - **regularMarketOpen** (number, float) *(nullable)* Preço de abertura no dia de negociação atual. - **averageDailyVolume3Month** (number, int64) *(nullable)* Média do volume financeiro diário negociado nos últimos 3 meses. - **averageDailyVolume10Day** (number, int64) *(nullable)* Média do volume financeiro diário negociado nos últimos 10 dias. - **fiftyTwoWeekLowChange** (number, float) *(nullable)* Variação absoluta entre o preço atual e o preço mínimo das últimas 52 semanas. - **fiftyTwoWeekRange** (string) *(nullable)* String formatada mostrando o intervalo de preço das últimas 52 semanas (Mínimo - Máximo). - **fiftyTwoWeekHighChange** (number, float) *(nullable)* Variação absoluta entre o preço atual e o preço máximo das últimas 52 semanas. - **fiftyTwoWeekHighChangePercent** (number, float) *(nullable)* Variação percentual entre o preço atual e o preço máximo das últimas 52 semanas. - **fiftyTwoWeekLow** (number, float) *(nullable)* Preço mínimo atingido nas últimas 52 semanas. - **fiftyTwoWeekHigh** (number, float) *(nullable)* Preço máximo atingido nas últimas 52 semanas. - **priceEarnings** (number, float) *(nullable)* Indicador Preço/Lucro (P/L): Preço Atual / Lucro Por Ação (LPA) TTM. Retornado se `fundamental=true`. - **earningsPerShare** (number, float) *(nullable)* Lucro Por Ação (LPA) dos últimos 12 meses (TTM). Retornado se `fundamental=true`. - **logourl** (string, url) URL da imagem do logo do ativo/empresa. - **updatedAt** (string, date-time) *(nullable)* Timestamp da última atualização dos dados do índice na fonte (aplicável principalmente a índices, como `^BVSP`). Formato ISO 8601. - **usedInterval** (string) *(nullable)* O intervalo (`interval`) efetivamente utilizado pela API para retornar os dados históricos, caso solicitado. - **usedRange** (string) *(nullable)* O período (`range`) efetivamente utilizado pela API para retornar os dados históricos, caso solicitado. - **historicalDataPrice** (array) *(nullable)* Array contendo a série histórica de preços, retornado apenas se os parâmetros `range` e/ou `interval` forem especificados na requisição. Array items: Reference to: **HistoricalDataPrice** - **validRanges** (array) Lista dos valores válidos que podem ser utilizados no parâmetro `range` para este ativo específico. Array items: **Type:** string - **validIntervals** (array) Lista dos valores válidos que podem ser utilizados no parâmetro `interval` para este ativo específico. Array items: **Type:** string - **dividendsData** *(nullable)* Objeto contendo informações sobre dividendos, JCP e outros eventos corporativos. Retornado apenas se `dividends=true` for especificado na requisição. Reference to: **DividendsData** - **summaryProfile** *(nullable)* Resumo do perfil da empresa. Retornado apenas se `modules` incluir `summaryProfile`. Reference to: **SummaryProfile** - **balanceSheetHistory** (array) *(nullable)* Histórico **anual** do Balanço Patrimonial. Retornado apenas se `modules` incluir `balanceSheetHistory`. Array items: Reference to: **BalanceSheetEntry** - **balanceSheetHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** do Balanço Patrimonial. Retornado apenas se `modules` incluir `balanceSheetHistoryQuarterly`. Array items: Reference to: **BalanceSheetEntry** - **defaultKeyStatistics** *(nullable)* Principais estatísticas financeiras atuais/TTM. Retornado apenas se `modules` incluir `defaultKeyStatistics`. Reference to: **DefaultKeyStatisticsEntry** - **defaultKeyStatisticsHistory** (array) *(nullable)* Histórico **anual** das principais estatísticas. Retornado apenas se `modules` incluir `defaultKeyStatisticsHistory`. Array items: Reference to: **DefaultKeyStatisticsEntry** - **defaultKeyStatisticsHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** das principais estatísticas. Retornado apenas se `modules` incluir `defaultKeyStatisticsHistoryQuarterly`. Array items: Reference to: **DefaultKeyStatisticsEntry** - **incomeStatementHistory** (array) *(nullable)* Histórico **anual** da Demonstração do Resultado (DRE). Retornado apenas se `modules` incluir `incomeStatementHistory`. Array items: Reference to: **IncomeStatementEntry** - **incomeStatementHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** da Demonstração do Resultado (DRE). Retornado apenas se `modules` incluir `incomeStatementHistoryQuarterly`. Array items: Reference to: **IncomeStatementEntry** - **financialData** *(nullable)* Dados financeiros e indicadores TTM. Retornado apenas se `modules` incluir `financialData`. Reference to: **FinancialDataEntry** - **financialDataHistory** (array) *(nullable)* Histórico **anual** de dados financeiros e indicadores. Retornado apenas se `modules` incluir `financialDataHistory`. Array items: Reference to: **FinancialDataEntry** - **financialDataHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** de dados financeiros e indicadores. Retornado apenas se `modules` incluir `financialDataHistoryQuarterly`. Array items: Reference to: **FinancialDataEntry** - **valueAddedHistory** (array) *(nullable)* Histórico **anual** da Demonstração do Valor Adicionado (DVA). Retornado apenas se `modules` incluir `valueAddedHistory`. Array items: Reference to: **ValueAddedEntry** - **valueAddedHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** da Demonstração do Valor Adicionado (DVA). Retornado apenas se `modules` incluir `valueAddedHistoryQuarterly`. Array items: Reference to: **ValueAddedEntry** - **cashflowHistory** (array) *(nullable)* Histórico **anual** da Demonstração do Fluxo de Caixa (DFC). Retornado apenas se `modules` incluir `cashflowHistory`. Array items: Reference to: **CashflowEntry** - **cashflowHistoryQuarterly** (array) *(nullable)* Histórico **trimestral** da Demonstração do Fluxo de Caixa (DFC). Retornado apenas se `modules` incluir `cashflowHistoryQuarterly`. Array items: Reference to: **CashflowEntry** ### StockDividend Detalhes sobre um evento corporativo que afeta a quantidade de ações (Desdobramento/Split, Grupamento/Inplit, Bonificação). **Properties:** - **assetIssued** (string) Ticker do ativo afetado pelo evento. - **factor** (number, float) Fator numérico do evento. * **Bonificação:** Percentual (ex: 0.1 para 10%). * **Desdobramento/Grupamento:** Fator multiplicativo ou divisor. - **completeFactor** (string) Descrição textual do fator (ex: `1 / 10`, `10 / 1`). - **approvedOn** (string, date-time) Data em que o evento foi aprovado. Formato ISO 8601. - **isinCode** (string) *(nullable)* Código ISIN do ativo. - **label** (string) Tipo do evento: `DESDOBRAMENTO`, `GRUPAMENTO`, `BONIFICACAO`. - **lastDatePrior** (string, date-time) Data Com (Ex-Date). Último dia para possuir o ativo nas condições antigas. Formato ISO 8601. - **remarks** (string) *(nullable)* Observações adicionais sobre o evento. ### SummaryProfile Contém informações cadastrais e descritivas sobre a empresa. Retornado via `modules=summaryProfile`. **Properties:** - **address1** (string) *(nullable)* Linha 1 do endereço da sede da empresa. - **address2** (string) *(nullable)* Linha 2 do endereço da sede da empresa (complemento). - **city** (string) *(nullable)* Cidade da sede da empresa. - **state** (string) *(nullable)* Estado ou província da sede da empresa. - **zip** (string) *(nullable)* Código Postal (CEP) da sede da empresa. - **country** (string) *(nullable)* País da sede da empresa. - **phone** (string) *(nullable)* Número de telefone principal da empresa. - **website** (string) *(nullable)* URL do website oficial da empresa. - **industry** (string) *(nullable)* Nome da indústria em que a empresa atua. - **industryKey** (string) *(nullable)* Chave interna ou código para a indústria. - **industryDisp** (string) *(nullable)* Nome de exibição formatado para a indústria. - **sector** (string) *(nullable)* Nome do setor de atuação da empresa. - **sectorKey** (string) *(nullable)* Chave interna ou código para o setor. - **sectorDisp** (string) *(nullable)* Nome de exibição formatado para o setor. - **longBusinessSummary** (string) *(nullable)* Descrição longa e detalhada sobre as atividades e o negócio da empresa. - **fullTimeEmployees** (integer) *(nullable)* Número estimado de funcionários em tempo integral. - **companyOfficers** (array) *(nullable)* Lista de diretores e executivos principais da empresa (estrutura interna do objeto não detalhada aqui). Array items: ### ValueAddedEntry Representa os dados de uma Demonstração do Valor Adicionado (DVA) para um período específico (anual ou trimestral). A DVA mostra como a riqueza gerada pela empresa foi distribuída. **Properties:** - **symbol** (string) Ticker do ativo ao qual a DVA se refere. - **type** (string) - Options: `yearly`, `quarterly` Indica a periodicidade da DVA: `yearly` (anual) ou `quarterly` (trimestral). - **endDate** (string, date) Data de término do período fiscal ao qual a DVA se refere (YYYY-MM-DD). - **revenue** (number, int64) *(nullable)* Receitas (Venda de Mercadorias, Produtos e Serviços, etc.). Item 1 da DVA. - **financialIntermediationRevenue** (number, int64) *(nullable)* Receita de Intermediação Financeira (específico para bancos). - **revenueFromTheProvisionOfServices** (number, int64) *(nullable)* Receita da Prestação de Serviços (detalhamento). - **provisionOrReversalOfExpectedCreditRiskLosses** (number, int64) *(nullable)* Provisão/Reversão de Perdas com Risco de Crédito (PCLD). - **otherRevenues** (number, int64) *(nullable)* Outras Receitas. - **financialIntermediationExpenses** (number, int64) *(nullable)* Despesas de Intermediação Financeira (específico para bancos). - **suppliesPurchasedFromThirdParties** (number, int64) *(nullable)* Insumos Adquiridos de Terceiros (Custo de Mercadorias, Matérias-Primas). Item 2 da DVA. - **materialsEnergyAndOthers** (number, int64) *(nullable)* Custos com Materiais, Energia, Serviços de Terceiros e Outros. - **services** (number, int64) *(nullable)* Serviços de Terceiros (detalhamento). - **lossOrRecoveryOfAssetValues** (number, int64) *(nullable)* Perda / Recuperação de Valores de Ativos (Impairment). - **otherSupplies** (number, int64) *(nullable)* Outros Insumos. - **grossAddedValue** (number, int64) *(nullable)* Valor Adicionado Bruto (Receitas - Insumos). Item 3 da DVA. - **retentions** (number, int64) *(nullable)* Retenções (Depreciação, Amortização e Exaustão). Item 4 da DVA. - **depreciationAndAmortization** (number, int64) *(nullable)* Depreciação e Amortização. - **otherRetentions** (number, int64) *(nullable)* Outras Retenções (Exaustão, etc.). - **netAddedValue** (number, int64) *(nullable)* Valor Adicionado Líquido Produzido pela Entidade (Bruto - Retenções). Item 5 da DVA. - **addedValueReceivedByTransfer** (number, int64) *(nullable)* Valor Adicionado Recebido em Transferência (Resultado de Equivalência Patrimonial, Receitas Financeiras, etc.). Item 6 da DVA. - **equityIncomeResult** (number, int64) *(nullable)* Resultado de Equivalência Patrimonial (como receita na DVA). - **otherValuesReceivedByTransfer** (number, int64) *(nullable)* Outros Valores Recebidos (Receitas Financeiras, Aluguéis, etc.). - **addedValueToDistribute** (number, int64) *(nullable)* Valor Adicionado Total a Distribuir (Líquido Produzido + Recebido em Transferência). Item 7 da DVA. - **distributionOfAddedValue** (number, int64) *(nullable)* Distribuição do Valor Adicionado (Soma dos itens seguintes). Item 8 da DVA. - **teamRemuneration** (number, int64) *(nullable)* Pessoal e Encargos (Salários, Benefícios, FGTS). - **taxes** (number, int64) *(nullable)* Impostos, Taxas e Contribuições (Federais, Estaduais, Municipais). - **federalTaxes** (number, int64) *(nullable)* Impostos Federais (IRPJ, CSLL, PIS, COFINS, IPI). - **stateTaxes** (number, int64) *(nullable)* Impostos Estaduais (ICMS). - **municipalTaxes** (number, int64) *(nullable)* Impostos Municipais (ISS). - **remunerationOfThirdPartyCapitals** (number, int64) *(nullable)* Remuneração de Capitais de Terceiros (Juros, Aluguéis). - **equityRemuneration** (number, int64) *(nullable)* Remuneração de Capitais Próprios (JCP, Dividendos, Lucros Retidos). - **interestOnOwnEquity** (number, int64) *(nullable)* Juros sobre o Capital Próprio (JCP). - **dividends** (number, int64) *(nullable)* Dividendos Distribuídos. - **retainedEarningsOrLoss** (number, int64) *(nullable)* Lucros Retidos ou Prejuízo do Exercício. - **nonControllingShareOfRetainedEarnings** (number, int64) *(nullable)* Participação dos Não Controladores nos Lucros Retidos. - **otherDistributions** (number, int64) *(nullable)* Outras Distribuições. - **productSales** (number, int64) *(nullable)* Venda de Produtos e Serviços (detalhamento). - **constructionOfOwnAssets** (number, int64) *(nullable)* Construção de Ativos Próprios. - **provisionOrReversalOfDoubtfulAccounts** (number, int64) *(nullable)* Provisão/Reversão para Créditos de Liquidação Duvidosa (PCLD - como receita/despesa na DVA). - **costsWithProductsSold** (number, int64) *(nullable)* Custos dos Produtos, Mercadorias e Serviços Vendidos (detalhamento). - **thirdPartyMaterialsAndServices** (number, int64) *(nullable)* Materiais, Energia, Serviços de Terceiros. - **lossOrRecoveryOfAssets** (number, int64) *(nullable)* Perda/Recuperação de Valores de Ativos (Impairment - como custo/receita). - **netAddedValueProduced** (number, int64) *(nullable)* Valor Adicionado Líquido Produzido (sinônimo de `netAddedValue`). - **addedValueReceivedOnTransfer** (number, int64) *(nullable)* Valor Adicionado Recebido em Transferência (sinônimo de `addedValueReceivedByTransfer`). - **financialIncome** (number, int64) *(nullable)* Receitas Financeiras (como valor recebido em transferência). - **insuranceOperationsRevenue** (number, int64) *(nullable)* Receita com Operações de Seguros (específico para Seguradoras). - **complementaryPensionOperationsRevenue** (number, int64) *(nullable)* Receita com Operações de Previdência Complementar. - **feesRevenue** (number, int64) *(nullable)* Receita com Taxas e Comissões. - **variationsOfTechnicalProvisions** (number, int64) *(nullable)* Variações das Provisões Técnicas (específico para Seguradoras). - **insuranceOperationsVariations** (number, int64) *(nullable)* Variações de Operações de Seguros. - **pensionOperationsVariations** (number, int64) *(nullable)* Variações de Operações de Previdência. - **otherVariations** (number, int64) *(nullable)* Outras Variações. - **netOperatingRevenue** (number, int64) *(nullable)* Receita Operacional Líquida (detalhamento). - **claimsAndBenefits** (number, int64) *(nullable)* Sinistros Retidos e Benefícios. - **variationInDeferredSellingExpenses** (number, int64) *(nullable)* Variação nas Despesas de Comercialização Diferidas. - **resultsOfCededReinsuranceOperations** (number, int64) *(nullable)* Resultados de Operações de Resseguros Cedidos. - **resultOfCoinsuranceOperationsAssigned** (number, int64) *(nullable)* Resultado de Operações de Cosseguros Cedidos. - **totalAddedValueToDistribute** (number, int64) *(nullable)* Valor Adicionado Total a Distribuir (sinônimo de `addedValueToDistribute`). - **ownEquityRemuneration** (number, int64) *(nullable)* Remuneração de Capitais Próprios (sinônimo de `equityRemuneration`). - **updatedAt** (string, date) Data da última atualização deste registro específico na fonte de dados (YYYY-MM-DD).