--- title: "Cadeia de opções" method: GET path: "/api/v2/options/chain" tags: ["Opções"] --- # Cadeia de opções `GET /api/v2/options/chain` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/options/chain` - Auth: HTTP bearer Retorna as séries de opções de um vencimento, com dados do contrato (`symbol`, `side`, `strike`, `optionStyle`) e a cotação do último pregão até `date`: OHLC, bid, ask, volume e contratos em aberto. Use para montar uma tela de opções por vencimento, comparar calls e puts por strike e filtrar séries por faixa de strike. A lista traz só séries com cotação nos 10 dias até `date`. Cada série traz a cotação do seu último pregão nessa janela, que pode ser anterior a `date`. Confira o campo `date` de cada série antes de usar o preço como atual. Nas séries de `DOL` e `WDO`, `referencePrice` pode vir preenchido com `close`, `high` e `low` nulos, porque muitas séries não negociam no dia. Disponível no plano Pro. Sem token, aceita só `underlying=PETR4`. ## Query parameters - `underlying` string, required: Ticker do ativo subjacente: ação, ETF, índice, `DOL` ou `WDO`. - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD. Veja os vencimentos em `/expirations`. - `date` string: Data do pregão, no formato YYYY-MM-DD. Padrão: último pregão disponível. - `side` 'call' | 'put': Filtra por `call` ou `put`. Sem o filtro, retorna os dois. - `minStrike` number, nullable: Strike mínimo. - `maxStrike` number, nullable: Strike máximo. ## Response `200` Séries retornadas com sucesso. - OptionSeriesResponse - `underlying` string, required: Ativo subjacente consultado, em maiúsculas. - `expirationDate` string, required: Vencimento consultado, no formato YYYY-MM-DD. - `date` string, required: Último pregão com dados até a data pedida, no formato YYYY-MM-DD. - `tradedOnly` true, required: Sempre `true`: a lista traz só séries com cotação nos 10 dias até `date`. - `series` OptionSeriesSnapshot[], required: Séries do vencimento. Cada uma traz a cotação do seu último pregão até `date`. - `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. - `date` integer, required: Data do pregão, em timestamp Unix (segundos). - `open` number, nullable, required: Preço de abertura. - `high` number, nullable, required: Preço máximo. - `low` number, nullable, required: Preço mínimo. - `average` number, nullable, required: Preço médio. - `close` number, nullable, required: Preço de fechamento. - `referencePrice` number, nullable, required: Preço de referência do pregão. - `bid` number, nullable, required: Melhor oferta de compra no fechamento. - `ask` number, nullable, required: Melhor oferta de venda no fechamento. - `trades` number, nullable, required: Número de negócios. - `volume` number, nullable, required: Número de contratos negociados. - `financialVolume` number, nullable, required: Volume financeiro, em reais. - `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. - `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos. ## Changes - **2026-08-29** `40fae0b2d5fb`: 3 info - added the required property `series/items/openInterest` to the response with the `200` status - added the required property `series/items/openInterestChange` to the response with the `200` status - added the required property `series/items/openInterestDate` to the response with the `200` status - **2026-08-25** `297945b14cad`: 1 warning, 1 info - added the new `currency` enum value to the `series/items/market` response property for the response status `200` - added the required property `series/items/referencePrice` to the response with the `200` status - **2026-07-10** `f275d46193ea`: 1 info - added the non-success response with the status `503` - **2026-05-22** `c9743d203cb0`: 2 info - added the required property `series/items/allocationRoundLot` to the response with the `200` status - added the required property `series/items/optionStyle` to the response with the `200` status - **2026-04-26** `3ae1b2752c0b`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/options/chain/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)