# Histórico de Gregas e IV de Opções
URL: /docs/opcoes/analytics-historico.mdx

Consulte a série temporal EOD de volatilidade implícita e gregas calculadas para uma opção específica.

***

title: Histórico de Gregas e IV de Opções
description: >-
Consulte a série temporal EOD de volatilidade implícita e gregas calculadas
para uma opção específica.
full: true
keywords: brapi, api, opções, histórico, gregas, volatilidade implícita
openGraph:
title: Histórico de Gregas e IV de Opções
description: >-
Série temporal EOD de volatilidade implícita e gregas calculadas para uma
opção específica.
type: website
locale: pt\_BR
lastUpdated: '2026-06-01T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/options/analytics/history
structuredData:
headings: \[]
contents:

* content: >-
  Retorna a série temporal EOD de IV e gregas calculadas para uma
  opção específica.

***

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

Retorna uma série temporal diária com volatilidade implícita, delta, gamma,
theta, vega e rho para uma opção específica.

Use este endpoint quando você já sabe o `symbol` e o `expirationDate` da série.
Se o mesmo `symbol` existir mais de uma vez no vencimento, informe também
`strike`.

<Callout type="info">
  **Plano mínimo: Pro.** No sandbox sem token, aceita apenas símbolos que
  começam com `PETR`.
</Callout>





## Swagger Documentation

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

Single endpoint documentation for /api/v2/options/analytics/history

## Base URLs

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

## GET /api/v2/options/analytics/history

**Summary:** Obter histórico de gregas e IV de uma série de opção

Retorna a série temporal EOD de IV e gregas calculadas para uma única opção. Sem token, o sandbox aceita apenas símbolos com prefixo `PETR`.

**Tags:** Opções

### Parameters

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

### Responses

#### 200

Histórico de análises 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)


### OptionAnalyticsHistoryResponse

**Properties:**

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

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

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


### OptionAnalyticsPoint

**Properties:**

- **date** (string) *(required)*
  Data do pregão, no formato YYYY-MM-DD.

- **model** (string) - Options: `black-scholes-merton`, `barone-adesi-whaley`, `cox-ross-rubinstein`, `unsupported` *(required)*
  Modelo usado na precificação. Séries americanas usam aproximação binomial; séries europeias usam Black-Scholes-Merton.

- **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)*
  Preço usado como entrada para resolver IV. Em opções de ações/índices, v1 usa apenas fechamento negociado (`close`).

- **underlyingPrice** (number) *(nullable)* *(required)*
  Preço do ativo subjacente usado no cálculo.

- **optionPrice** (number) *(nullable)* *(required)*
  Preço da opção usado para resolver a volatilidade implícita.

- **riskFreeRate** (number) *(nullable)* *(required)*
  Taxa livre de risco anual em decimal (ex.: 0.105 para 10,5%).

- **dividendYield** (number) *(nullable)* *(required)*
  Yield contínuo derivado de dividendos anunciados conhecidos até a data de cálculo. `0` quando não há dividendo anunciado aplicável.

- **timeToExpirationYears** (number) *(nullable)* *(required)*
  Tempo até o vencimento em anos.

- **impliedVolatility** (number) *(nullable)* *(required)*
  Volatilidade implícita anualizada em decimal.

- **delta** (number) *(nullable)* *(required)*
  Delta da opção.

- **gamma** (number) *(nullable)* *(required)*
  Gamma da opção.

- **theta** (number) *(nullable)* *(required)*
  Theta anualizado da opção.

- **vega** (number) *(nullable)* *(required)*
  Vega da opção.

- **rho** (number) *(nullable)* *(required)*
  Rho da opção.

- **confidence** (string) - Options: `high`, `medium`, `low`, `none` *(required)*
  Confiança operacional do cálculo. `none` indica que as gregas/IV ficaram nulas e `nullReason` explica o motivo.

- **nullReason** (string) *(nullable)* *(required)*
  Motivo para campos calculados nulos, quando aplicável (ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`).


### OptionSeries

**Properties:**

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

- **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).

- **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)*
  Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro.

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

- **allocationRoundLot** (integer) *(nullable)* *(required)*
  Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras.

- **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).


### OptionSeriesWithAnalyticsHistory