--- title: "Histórico de gregas e IV" method: GET path: "/api/v2/options/analytics/history" tags: ["Opções"] --- # Histórico de gregas e IV `GET /api/v2/options/analytics/history` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/options/analytics/history` - Auth: HTTP bearer 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](https://brapi.dev/docs/opcoes/analytics). 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`. ## Query parameters - `symbol` string, required: Código da série de opção. - `expirationDate` string, required: Data de vencimento da série, no formato YYYY-MM-DD. - `strike` number, nullable: Preço de exercício. Use quando o mesmo `symbol` aparece mais de uma vez no vencimento. - `startDate` string: Data inicial, no formato YYYY-MM-DD. Padrão: 12 meses atrás. - `endDate` string: Data final, no formato YYYY-MM-DD. Padrão: hoje. - `sortOrder` 'asc' | 'desc': Ordem por data: `asc` do mais antigo ao mais recente, `desc` do mais recente ao mais antigo. ## Response `200` Histórico de análises retornado com sucesso. - OptionAnalyticsHistoryResponse - `option` OptionSeriesWithAnalyticsHistory, required - `symbol` string, required: Código da série de opção. Ex.: PETRF783. - `underlyingSymbol` string, nullable, required: Ativo subjacente da opção. Ex.: PETR4. - `side` 'call' | 'put', required: `call` (opção de compra) ou `put` (opção de venda). - `market` 'equity' | 'index' | 'currency', required: Mercado da opção: `equity` para ação ou ETF, `index` para índice, `currency` para DOL e WDO. - `optionStyle` 'american' | 'european', nullable, required: `american` permite exercício até o vencimento. `european` permite exercício só no vencimento. Nulo quando o cadastro da série não informa o estilo. - `strike` number, nullable, required: Preço de exercício da opção. - `allocationRoundLot` integer, nullable, required: Lote padrão de negociação. Em geral, 100 nas opções sobre ações. - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD. - `firstTradeDate` string, required: Data do primeiro pregão da série, no formato YYYY-MM-DD. - `lastTradeDate` string, required: Data do último pregão da série, no formato YYYY-MM-DD. - `analytics` object[], required: Um ponto de IV e gregas por pregão no intervalo pedido. - `date` string, required: Data do pregão, no formato YYYY-MM-DD. - `model` 'black-scholes-merton' | 'barone-adesi-whaley' | 'cox-ross-rubinstein' | 'unsupported', required: Modelo de cálculo. Séries americanas usam árvore binomial (`cox-ross-rubinstein`). Séries europeias usam `black-scholes-merton`. `unsupported` quando o estilo da opção é desconhecido. - `priceSource` 'close' | 'referencePrice' | 'none', required: Preço usado para calcular a IV. Aqui é sempre `close` ou `none`. Sem negócio no dia, não há cálculo. - `underlyingPrice` number, nullable, required: Preço do ativo subjacente usado no cálculo. - `optionPrice` number, nullable, required: Preço da opção usado para calcular 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 dos dividendos anunciados até a data do cálculo. `0` sem dividendo anunciado. Não inclui estimativas. - `timeToExpirationYears` number, nullable, required: Dias corridos até o vencimento divididos por 365, inclusive em anos bissextos. - `impliedVolatility` number, nullable, required: Volatilidade implícita anual, em decimal. O cálculo usa tempo em dias corridos dividido por 365. - `delta` number, nullable, required: Variação do prêmio para 1 unidade de variação no ativo subjacente. - `gamma` number, nullable, required: Variação do delta para 1 unidade de variação no ativo subjacente. - `theta` number, nullable, required: Variação do prêmio com a passagem do tempo, por ano. - `vega` number, nullable, required: Variação do prêmio para 1,00 de variação na volatilidade. Divida por 100 para 1 ponto percentual. - `rho` number, nullable, required: Variação do prêmio para 1,00 de variação na taxa de juro. Divida por 100 para 1 ponto percentual. - `confidence` 'high' | 'medium' | 'low' | 'none', required: Confiança do cálculo. `none` indica IV e gregas nulas, com o motivo em `nullReason`. - `nullReason` string, nullable, required: Motivo dos campos calculados nulos. Ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`. - `openInterest` number, nullable, required: Contratos em aberto na série, na última apuração até a data pedida. - `openInterestChange` number, nullable, required: Variação de contratos em aberto desde a apuração anterior. - `openInterestDate` string, nullable, required: Data da apuração usada, no formato YYYY-MM-DD. Pode ser anterior à data do pregão. - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `500`: Erro interno do servidor. ## Changes - **2026-08-29** `40fae0b2d5fb`: 3 info - added the required property `option/allOf[subschema #2]/analytics/items/openInterest` to the response with the `200` status - added the required property `option/allOf[subschema #2]/analytics/items/openInterestChange` to the response with the `200` status - added the required property `option/allOf[subschema #2]/analytics/items/openInterestDate` to the response with the `200` status - **2026-08-25** `297945b14cad`: 1 warning - added the new `currency` enum value to the `option/allOf[#/components/schemas/OptionSeries]/market` response property for the response status `200` - **2026-06-02** `abb7cb3b8676`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/options/analytics/history/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)