# Histórico de uma Série de Opção
URL: /docs/opcoes/historico.mdx

Consulte o histórico diário de uma série de opção por símbolo e vencimento, com resposta simples e pronta para gráfico ou backtest.

***

title: Histórico de uma Série de Opção
description: >-
Consulte o histórico diário de uma série de opção por símbolo e vencimento,
com resposta simples e pronta para gráfico ou backtest.
full: true
keywords: brapi, api, opções, histórico, série
openGraph:
title: Histórico de uma Série de Opção
description: >-
Consulte o histórico diário de uma série de opção por símbolo e
vencimento.
type: website
locale: pt\_BR
lastUpdated: '2026-04-22T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/options/historical
structuredData:
headings: \[]
contents:

* content: >-
  Retorna o histórico diário EOD de uma única série de opção,
  identificada por símbolo e vencimento. Pronto para gráfico ou
  backtest.

***

import { Callout } from 'fumadocs-ui/components/callout';

Retorna o histórico diário EOD de uma única série de opção, identificada por
`symbol` e `expirationDate`. Informe também `strike` quando o mesmo símbolo
aparecer mais de uma vez no mesmo vencimento.

Normalmente você descobre a série primeiro em
[Séries Negociadas](/docs/opcoes/series) e só depois chama este endpoint. Foi
desenhado para **uma série por requisição**, para manter a integração simples
e evitar ambiguidades.

<Callout type="info">
  **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbol` começando
  com `PETR` (opções do subjacente PETR4).
</Callout>





## Swagger Documentation

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

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

## Base URLs

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

## GET /api/v2/options/historical

**Summary:** Obter histórico diário de uma série de opção

Retorna o histórico diário EOD de uma única série, identificada por `symbol` e `expirationDate`. Sem token, o sandbox aceita apenas símbolos com prefixo `PETR` (opções de PETR4).

**Tags:** Opções

### Parameters

- **symbol** (query) *required*
- **expirationDate** (query) *required*
- **strike** (query)
- **startDate** (query)
- **endDate** (query)
- **sortOrder** (query)

### Responses

#### 200

Histórico retornado com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

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


### OptionHistoricalResponse

**Properties:**

- **option** *(required)*
  Reference to: **OptionSeriesWithHistory**

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

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


### OptionPricePoint

**Properties:**

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

- **open** (number) *(nullable)* *(required)*
  Preço de abertura do pregão.

- **high** (number) *(nullable)* *(required)*
  Máxima do pregão.

- **low** (number) *(nullable)* *(required)*
  Mínima do pregão.

- **average** (number) *(nullable)* *(required)*
  Preço médio do pregão.

- **close** (number) *(nullable)* *(required)*
  Preço de fechamento do pregão.

- **bid** (number) *(nullable)* *(required)*
  Melhor oferta de compra registrada no fechamento.

- **ask** (number) *(nullable)* *(required)*
  Melhor oferta de venda registrada no fechamento.

- **trades** (number) *(nullable)* *(required)*
  Número de negócios realizados no pregão.

- **volume** (number) *(nullable)* *(required)*
  Volume negociado no pregão (em contratos).

- **financialVolume** (number) *(nullable)* *(required)*
  Volume financeiro negociado no pregão (em BRL).


### OptionSeries

**Properties:**

- **symbol** (string) *(required)*
  Código de negociação da série (ex: PETRE370).

- **underlyingSymbol** (string) *(nullable)* *(required)*
  Ativo subjacente da opção (ex: PETR4).

- **side** (string) - Options: `call`, `put` *(required)*
  Tipo da opção: `call` (opção de compra) ou `put` (opção de venda).

- **market** (string) - Options: `equity`, `index` *(required)*
  Mercado da opção: `equity` (ação/ETF) ou `index` (índice).

- **strike** (number) *(nullable)* *(required)*
  Preço de exercício (strike) da opção.

- **expirationDate** (string) *(required)*
  Data de vencimento da série, no formato YYYY-MM-DD.

- **firstTradeDate** (string) *(required)*
  Data do primeiro pregão observado para a série (YYYY-MM-DD).

- **lastTradeDate** (string) *(required)*
  Data do último pregão observado para a série (YYYY-MM-DD).


### OptionSeriesWithHistory

Metadados da série consultada acompanhados de `history`, com um ponto OHLCV por pregão no intervalo pedido.