# 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&dividends=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&dividends=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).


