---
title: "Listar contratos futuros"
method: GET
path: "/api/v2/futures/list"
tags: ["Futuros"]
---

# Listar contratos futuros

`GET /api/v2/futures/list`

Retorna a lista de contratos futuros, com filtros por ativo, segmento e vencimento.

## Query parameters

- `asset` string — Filtra por código do ativo (ex.: `WIN`, `BGI`, `DI1`).
- `segment` 'financial' | 'agribusiness' — Filtra por segmento.
- `includeExpired` 'true' | 'false' — `true` inclui contratos vencidos. Padrão: `false`.
- `page` integer — Número da página (começa em 1).
- `limit` integer — Itens por página (máx. 100).
- `sortBy` 'symbol' | 'expirationDate' | 'underlyingAsset'
- `sortOrder` 'asc' | 'desc'

## Response `200`

Lista de contratos.

- FutureListResponse
  - `futures` FutureSpecs[], required
    - `symbol` string, required — Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`).
    - `underlyingAsset` string, required — Código do ativo (ex.: `WIN`, `BGI`, `DI1`).
    - `assetDescription` string, nullable, required — Nome do ativo em português.
    - `segment` 'financial' | 'agribusiness', required — `financial` = índices, juros e moeda. `agribusiness` = commodities.
    - `quotationType` 'price' | 'rate', required — `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais.
    - `expirationDate` string, required — Data de vencimento (YYYY-MM-DD).
    - `firstTradeDate` string, nullable, required — Data do primeiro pregão.
    - `lastTradeDate` string, nullable, required — Data do último pregão.
    - `contractMultiplier` number, nullable, required — Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1.
    - `allocationRoundLot` integer, nullable, required — Tamanho do lote.
    - `tradingCurrency` string, nullable, required — Moeda (quase sempre `BRL`).
    - `deliveryType` string, nullable, required — Tipo de entrega: `Financial` ou `Physical`.
    - `exerciseType` string, nullable, required — Tipo de cotação: `Price` ou `Rate`.
    - `isin` string, nullable, required — Código ISIN.
    - `cficCode` string, nullable, required — Código CFI.
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
  - `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
- `500` — Erro interno do servidor

---

[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)