# Histórico de Ações
URL: /docs/acoes/historico.mdx

Séries históricas OHLCV para ações, BDRs, ETFs, FIIs, units e índices B3 no padrão composável /api/v2/stocks.

***

title: Histórico de Ações
description: >-
Séries históricas OHLCV para ações, BDRs, ETFs, FIIs, units e índices B3 no
padrão composável /api/v2/stocks.
full: true
keywords: brapi, api, ações, histórico, ohlcv, stocks, historical, v2, b3
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/stocks/historical
--------------------------------

Endpoint para buscar séries históricas OHLCV de um ou mais tickers. Use
quando você precisa de preços no tempo, sem carregar cotação atual, dividendos
ou módulos financeiros.

O endpoint aceita `range`/`interval` ou `startDate`/`endDate`, respeitando os
limites do plano. Tickers antigos são resolvidos para o ticker atual quando
houver renome conhecido, e a resposta inclui `requestedSymbol`, `symbol` e
`changed`.

Para snapshot de cotação, use `/api/v2/stocks/quote`. Para descobrir ou validar
tickers antes da consulta, use `/api/v2/tickers`.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/historical

Single endpoint documentation for /api/v2/stocks/historical

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/stocks/historical

**Summary:** Histórico v2 de ações


Retorna séries históricas OHLCV para um ou mais tickers B3.

Use este endpoint quando você precisa apenas de preços históricos. Para
snapshot de cotação, use `/api/v2/stocks/quote`; para descobrir tickers,
use `/api/v2/tickers`.

O endpoint aceita `range`/`interval` ou `startDate`/`endDate` e respeita
os mesmos limites de plano do comportamento histórico legado em
`/api/quote/{tickers}`.


**Tags:** Ações

### Parameters

- **symbols** (query) *required*
- **range** (query)
- **interval** (query)
- **startDate** (query)
- **endDate** (query)
- **sortOrder** (query)

### Responses

#### 200

Histórico recuperado com sucesso.

#### 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

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### StockHistoricalPrice

**Properties:**

- **date** (integer) *(required)*
  Data do pregão em Unix timestamp (segundos).

- **open** (number) *(nullable)* *(required)*

- **high** (number) *(nullable)* *(required)*

- **low** (number) *(nullable)* *(required)*

- **close** (number) *(nullable)* *(required)*

- **volume** (number) *(nullable)* *(required)*

- **adjustedClose** (number) *(nullable)* *(required)*


### StockHistoricalResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **StockHistoricalResult**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### StockHistoricalResult

**Properties:**

- **requestedSymbol** (string) *(required)*
  Ticker informado na requisição.

- **symbol** (string) *(required)*
  Ticker retornado pela brapi após normalização/renome.

- **changed** (boolean) *(required)*
  `true` quando o ticker informado foi resolvido para outro ticker.

- **data** *(required)*
  Reference to: **StockHistoricalSeries**


### StockHistoricalSeries

**Properties:**

- **usedInterval** (string) *(required)*

- **usedRange** (string) *(required)*

- **historicalDataPrice** (array) *(required)*
  Array items:
    Reference to: **StockHistoricalPrice**