# Séries Negociadas de Opções
URL: /docs/opcoes/series.mdx

Consulte as séries negociadas de opções para um vencimento específico, com preço, volume e filtros por compra/venda e faixa de strike.

***

title: Séries Negociadas de Opções
description: >-
Consulte as séries negociadas de opções para um vencimento específico, com
preço, volume e filtros por compra/venda e faixa de strike.
full: true
keywords: brapi, api, opções, séries, vencimento
openGraph:
title: Séries Negociadas de Opções
description: >-
Consulte as séries negociadas de opções para um vencimento específico.
type: website
locale: pt\_BR
lastUpdated: '2026-04-22T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/options/chain
structuredData:
headings: \[]
contents:

* content: >-
  Retorna as séries negociadas de um vencimento com metadados do
  contrato e OHLCV do último pregão disponível até a data pedida.

***

import { Callout } from 'fumadocs-ui/components/callout';

Retorna as séries negociadas de um vencimento com metadados do contrato
(`symbol`, `side`, `strike`, `expirationDate`) e OHLCV do último pregão
disponível até a data pedida. Este é o endpoint principal para montar uma
tela de opções por vencimento.

Apesar do caminho ser `/chain`, na documentação chamamos isso de **séries
negociadas**, porque esse nome faz mais sentido para o público brasileiro.

<Callout type="info">
  **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`.
</Callout>





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/chain

Single endpoint documentation for /api/v2/options/chain

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/options/chain

**Summary:** 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`.

**Tags:** Opções

### Parameters

- **underlying** (query) *required*
- **expirationDate** (query) *required*
- **date** (query)
- **side** (query)
- **minStrike** (query)
- **maxStrike** (query)

### Responses

#### 200

Séries retornadas com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### OptionSeriesResponse

**Properties:**

- **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** (boolean) - Options: `true` *(required)*
  Sempre `true`: só aparecem séries que tiveram negócio no pregão selecionado.

- **series** (array) *(required)*
  Séries negociadas no vencimento, com metadados do contrato e OHLCV do pregão em `date`.
  Array items:
    Reference to: **OptionSeriesSnapshot**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### OptionSeriesSnapshot

**Properties:**

- **symbol** (string) *(required)*
  Código de negociação da série (ex: PETRE370).

- **underlyingSymbol** (string) *(nullable)* *(required)*
  Ativo subjacente da opção (ex: PETR4).

- **side** (string) - Options: `call`, `put` *(required)*
  Tipo da opção: `call` (opção de compra) ou `put` (opção de venda).

- **market** (string) - Options: `equity`, `index` *(required)*
  Mercado da opção: `equity` (ação/ETF) ou `index` (índice).

- **strike** (number) *(nullable)* *(required)*
  Preço de exercício (strike) da opção.

- **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).