---
title: "Listar séries negociadas de opções"
method: GET
path: "/api/v2/options/chain"
tags: ["Opções"]
---

# Listar séries negociadas de opções

`GET /api/v2/options/chain`

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`.

## Query parameters

- `underlying` string, required — Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.
- `expirationDate` string, required — Data de vencimento das opções, no formato YYYY-MM-DD. Use `/expirations` para descobrir os vencimentos disponíveis.
- `date` string — Data EOD usada para buscar preço e volume do dia, no formato YYYY-MM-DD. Padrão: último pregão disponível.
- `side` 'call' | 'put' — Filtra por tipo da opção: `call` (compra) ou `put` (venda). Omita para retornar ambos.
- `minStrike` number, nullable — Strike mínimo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.
- `maxStrike` number, nullable — Strike máximo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.

## Response `200`

Séries retornadas com sucesso.

- OptionSeriesResponse
  - `underlying` string, required — Ativo subjacente consultado, normalizado em maiúsculas.
  - `expirationDate` string, required — Vencimento consultado, no formato YYYY-MM-DD.
  - `date` string, required — Data EOD efetivamente usada para buscar preço e volume, no formato YYYY-MM-DD.
  - `tradedOnly` true, required — Sempre `true`: só aparecem séries que tiveram negócio no pregão selecionado.
  - `series` OptionSeriesSnapshot[], required — Séries negociadas no vencimento, com metadados do contrato e OHLCV do pregão em `date`.
    - `symbol` string, required — Código de negociação da série (ex: PETRF783).
    - `underlyingSymbol` string, nullable, required — Ativo subjacente da opção (ex: PETR4).
    - `side` 'call' | 'put', required — Tipo da opção: `call` (opção de compra) ou `put` (opção de venda).
    - `market` 'equity' | 'index', required — Mercado da opção: `equity` (ação/ETF) ou `index` (índice).
    - `optionStyle` 'american' | 'european', nullable, required — Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro.
    - `strike` number, nullable, required — Preço de exercício (strike) da opção.
    - `allocationRoundLot` integer, nullable, required — Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras.
    - `expirationDate` string, required — Data de vencimento da série, no formato YYYY-MM-DD.
    - `firstTradeDate` string, required — Data do primeiro pregão observado para a série (YYYY-MM-DD).
    - `lastTradeDate` string, required — Data do último pregão observado para a série (YYYY-MM-DD).
    - `date` integer, required — Data do pregão em timestamp Unix (segundos).
    - `open` number, nullable, required — Preço de abertura do pregão.
    - `high` number, nullable, required — Máxima do pregão.
    - `low` number, nullable, required — Mínima do pregão.
    - `average` number, nullable, required — Preço médio do pregão.
    - `close` number, nullable, required — Preço de fechamento do pregão.
    - `bid` number, nullable, required — Melhor oferta de compra registrada no fechamento.
    - `ask` number, nullable, required — Melhor oferta de venda registrada no fechamento.
    - `trades` number, nullable, required — Número de negócios realizados no pregão.
    - `volume` number, nullable, required — Volume negociado no pregão (em contratos).
    - `financialVolume` number, nullable, required — Volume financeiro negociado no pregão (em BRL).
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `500` — Erro interno do servidor
- `503` — Serviço externo temporariamente indisponível

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)