v20

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

Opções

Listar séries negociadas de opções

Retorna as séries negociadas de um vencimento, combinando metadados do contrato com o último OHLCV disponível até a data solicitada. Sem token, o sandbox aceita apenas underlying=PETR4.

get/api/v2/options/chain

Query parameters

underlyingstring required

Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.

Example:PETR4

expirationDatestring required

Data de vencimento das opções, no formato YYYY-MM-DD. Use /expirations para descobrir os vencimentos disponíveis.

Example:2026-12-18

datestring

Data EOD usada para buscar preço e volume do dia, no formato YYYY-MM-DD. Padrão: último pregão disponível.

Example:2026-06-01

side'call' | 'put'

Filtra por tipo da opção: call (compra) ou put (venda). Omita para retornar ambos.

minStrikenumber nullable

Strike mínimo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.

maxStrikenumber nullable

Strike máximo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.

Response

Séries retornadas com sucesso.

underlyingstring required

Ativo subjacente consultado, normalizado em maiúsculas.

expirationDatestring required

Vencimento consultado, no formato YYYY-MM-DD.

datestring required

Data EOD efetivamente usada para buscar preço e volume, no formato YYYY-MM-DD.

tradedOnlytrue required

Sempre true: só aparecem séries que tiveram negócio no pregão selecionado.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "underlying": "PETR4",
  "expirationDate": "2026-12-18",
  "date": "2026-06-01",
  "tradedOnly": true,
  "series": [
    {
      "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",
      "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": 7
}