BRbrapi-dev
Opções

Histórico de gregas e IV

Changed on

Retorna o histórico diário de volatilidade implícita e gregas de uma série de opção, identificada por symbol e expirationDate.

Use para ver como a IV reagiu a eventos, como balanço, decisão de juros ou o vencimento, e para testar estratégias com gregas.

Os campos seguem as regras de gregas e IV. Se o mesmo symbol aparece duas vezes no vencimento, passe também strike.

Disponível no plano Pro. Sem token, aceita só symbol com prefixo PETR.

get/api/v2/options/analytics/history

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/options/analytics/history
  • Auth
    HTTP bearer

Query parameters

symbolstring required

Código da série de opção.

Example:PETRF783
expirationDatestring required

Data de vencimento da série, no formato YYYY-MM-DD.

Example:2026-12-18
strikenumber nullable

Preço de exercício. Use quando o mesmo symbol aparece mais de uma vez no vencimento.

Example:7.29
startDatestring

Data inicial, no formato YYYY-MM-DD. Padrão: 12 meses atrás.

Example:2026-05-01
endDatestring

Data final, no formato YYYY-MM-DD. Padrão: hoje.

Example:2026-06-01
sortOrder'asc' | 'desc'

Ordem por data: asc do mais antigo ao mais recente, desc do mais recente ao mais antigo.

Response

Histórico de análises retornado com sucesso.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "option": {
    "symbol": "PETRF783",
    "underlyingSymbol": "PETR4",
    "side": "call",
    "market": "equity",
    "optionStyle": "european",
    "strike": 7.29,
    "allocationRoundLot": 100,
    "expirationDate": "2026-12-18",
    "firstTradeDate": "2026-04-24",
    "lastTradeDate": "2026-06-01",
    "analytics": [
      {
        "date": "2026-05-29",
        "model": "black-scholes-merton",
        "priceSource": "close",
        "underlyingPrice": 42,
        "optionPrice": 34.8,
        "riskFreeRate": 0.145,
        "dividendYield": 0,
        "timeToExpirationYears": 0.057534248,
        "impliedVolatility": 3.0155768,
        "delta": 0.99739844,
        "gamma": 0.0002648198,
        "theta": -3.1521828,
        "vega": 0.08104867,
        "rho": 0.4079601,
        "confidence": "medium",
        "nullReason": null,
        "openInterest": 12500,
        "openInterestChange": 350,
        "openInterestDate": "2026-06-01"
      }
    ]
  },
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 10
}

Changes

  • 40fae0b2d5fbRevision changes
    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

  • 297945b14cadRevision changes
    • warning

      added the new currency enum value to the ///// response property for the response status