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

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

***

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

* content: >-
  Retorna a série temporal EOD de IV e gregas calculadas para uma
  opção sobre futuro 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 sobre futuro específica.

Use este endpoint quando você já sabe o `symbol` da série.

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





## Swagger Documentation

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

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

## Base URLs

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

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

**Summary:** Histórico de gregas e IV

Retorna a série temporal EOD de volatilidade implícita e gregas calculadas para uma única opção sobre futuro.

**Tags:** Opções sobre Futuros

### Parameters

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

### Responses

#### 200

Histórico de análises.

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


### FutureOptionAnalyticsHistoryResponse

**Properties:**

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

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

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


### FutureOptionAnalyticsPoint

**Properties:**

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

- **model** (string) - Options: `black-76`, `cox-ross-rubinstein-futures`, `unsupported` *(required)*
  Modelo usado na precificação. Opções europeias sobre futuros usam Black-76; opções americanas usam aproximação binomial.

- **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)*
  Preço usado para resolver IV. `referencePrice` é preço de referência oficial e vem com confiança menor que fechamento negociado.

- **underlyingPrice** (number) *(nullable)* *(required)*
  Preço do contrato futuro 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.

- **dividendYield** (number) *(nullable)* *(required)*
  Sempre `0` para opções sobre futuros em v1.

- **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. `low` é esperado quando o cálculo usa `referencePrice`.

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


### FutureOptionSpecs

**Properties:**

- **symbol** (string) *(required)*
  Código da opção (ex.: `BGIH27C028550`).

- **underlyingAsset** (string) *(required)*
  Código do ativo (ex.: `BGI`).

- **underlyingFuture** (string) *(nullable)* *(required)*
  Contrato futuro de base, quando existir.

- **optionType** (string) - Options: `call`, `put` *(required)*
  `call` (compra) ou `put` (venda).

- **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)*
  `american` (exerce a qualquer momento) ou `european` (só no vencimento).

- **segment** (string) - Options: `financial`, `agribusiness` *(required)*
  `financial` ou `agribusiness`.

- **strike** (number) *(required)*
  Strike (preço combinado).

- **expirationDate** (string) *(required)*
  Data de vencimento (YYYY-MM-DD).

- **firstTradeDate** (string) *(nullable)* *(required)*
  Data do primeiro pregão.

- **lastTradeDate** (string) *(nullable)* *(required)*
  Data do último pregão.

- **contractMultiplier** (number) *(nullable)* *(required)*
  Multiplicador (vem do futuro de base).

- **allocationRoundLot** (integer) *(nullable)* *(required)*
  Tamanho do lote.

- **exerciseType** (string) *(nullable)* *(required)*
  Tipo de exercício.

- **automaticExercise** (boolean) *(nullable)* *(required)*
  `true` se a opção é exercida sozinha no vencimento.

- **premiumUpfront** (boolean) *(nullable)* *(required)*
  `true` se o prêmio é pago à vista, `false` se é diferido.

- **isin** (string) *(nullable)* *(required)*
  Código ISIN.

- **cficCode** (string) *(nullable)* *(required)*
  Código CFI.


### FutureOptionWithAnalyticsHistory