v20

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

Opções

Obter histórico diário de uma série de opção

Retorna o histórico diário EOD de uma única série, identificada por symbol e expirationDate. Sem token, o sandbox aceita apenas símbolos com prefixo PETR (opções de PETR4).

get/api/v2/options/historical

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 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",
    "history": [
      {
        "date": 1780282800,
        "open": 35.15,
        "high": 35.15,
        "low": 35.15,
        "average": 35.15,
        "close": 35.15,
        "bid": 0,
        "ask": 0,
        "trades": 1,
        "volume": 500,
        "financialVolume": 17575
      }
    ]
  },
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 8
}