---
title: "Estatísticas v2 de ações"
method: GET
path: "/api/v2/stocks/statistics"
tags: ["Ações"]
---

# Estatísticas v2 de ações

`GET /api/v2/stocks/statistics`

Retorna indicadores estatísticos atuais ou históricos. Use mode=history e period=annual|quarterly para séries; startDate/endDate filtram as linhas históricas por date/endDate.

## Query parameters

- `symbols` string, required — Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
- `period` 'annual' | 'quarterly' — Período dos dados históricos.
- `startDate` string — Data inicial em YYYY-MM-DD. Filtra linhas por date/endDate.
- `endDate` string — Data final em YYYY-MM-DD. Filtra linhas por date/endDate.
- `mode` 'current' | 'history' — `current` retorna o indicador atual/TTM; `history` retorna a série anual ou trimestral.

## Response `200`

Dados fundamentalistas recuperados com sucesso.

- StockStatisticsResponse
  - `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 formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `429` — Limite de requisições excedido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)