BRbrapi-dev
Opções

Histórico de opção

Changed on

Retorna o histórico diário de uma série de opção, identificada por symbol e expirationDate: OHLC, bid, ask, negócios e volume por pregão.

Use para montar gráficos de prêmio, fazer backtests e analisar a liquidez de uma série.

Se o mesmo symbol aparece duas vezes no vencimento, passe também strike. Encontre a série na cadeia de opções.

Séries fora do dinheiro passam dias sem negócio. Um pregão sem negócio não aparece no histórico.

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

get/api/v2/options/historical

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/options/historical
  • 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 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",
    "history": [
      {
        "date": 1780282800,
        "open": 35.15,
        "high": 35.15,
        "low": 35.15,
        "average": 35.15,
        "close": 35.15,
        "referencePrice": null,
        "bid": 0,
        "ask": 0,
        "trades": 1,
        "volume": 500,
        "financialVolume": 17575
      }
    ]
  },
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 8
}

Changes

  • 297945b14cadRevision changes
    • warning

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

    • info

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

  • c9743d203cb0Revision changes
    • info

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

    • info

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