v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Opções

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.

get/api/v2/options/analytics/history

Query parameters

symbolstring required

Símbolo da opção

Example:PETRF783

expirationDatestring required

Data de vencimento no formato YYYY-MM-DD

Example:2026-12-18

strikenumber nullable

Preço de exercício. Use quando o mesmo símbolo aparecer mais de uma vez no mesmo vencimento.

Example:7.29

startDatestring

Data de início no formato YYYY-MM-DD (padrão: 12 meses)

Example:2026-05-01

endDatestring

Data de fim no formato YYYY-MM-DD

Example:2026-06-01

sortOrder'asc' | 'desc'

Ordem dos pontos em history por data: asc do mais antigo ao mais recente, desc do mais recente ao mais antigo. Padrão desc.

Response

Histórico de análises retornado com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato 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
      }
    ]
  },
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 10
}