---
title: "Dados financeiros"
method: GET
path: "/api/v2/stocks/financial-data"
tags: ["Ações"]
---

# Dados financeiros

`GET /api/v2/stocks/financial-data`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/stocks/financial-data`
- Auth: HTTP bearer

Receita, lucro, EBITDA, margens, dívida, caixa e fluxo de caixa livre de uma empresa, em um único objeto.

Use para ver o resumo financeiro sem ler cada demonstração.

O padrão `mode=current` traz os últimos 12 meses. `mode=history` traz a série anual ou trimestral, conforme `period`, filtrada por `startDate` e `endDate`.

Para as linhas completas, use [balanço patrimonial](https://brapi.dev/docs/acoes/balanco-patrimonial), [DRE](https://brapi.dev/docs/acoes/dre) e [fluxo de caixa](https://brapi.dev/docs/acoes/fluxo-de-caixa).

## Query parameters

- `symbols` string, required: Tickers separados por vírgula. Ex.: PETR4,VALE3. `requestedSymbol` identifica o ticker enviado e `symbol` identifica os dados retornados.
- `period` 'annual' | 'quarterly': Período de cada linha: anual ou trimestral.
- `startDate` string: Data inicial no formato YYYY-MM-DD. Filtra pela data de encerramento do período.
- `endDate` string: Data final no formato YYYY-MM-DD. Filtra pela data de encerramento do período.
- `mode` 'current' | 'history': `current` traz o valor atual. `history` traz a série definida por `period`.

## Response `200`

Dados fundamentalistas recuperados com sucesso.

- StockFinancialDataResponse
  - `results` StockFundamentalsSeries[], required
    - `requestedSymbol` string, required
    - `symbol` string, required
    - `changed` boolean, required
    - `data` unknown
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `404`: Nenhum dado encontrado para o pedido.
- `429`: Limite de requisições excedido.
- `500`: Erro interno do servidor.

## Changes

- **2026-06-15** `73e0f61e068f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/stocks/financial-data/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)
