# Curva de Vencimentos
URL: /docs/futuros/curva-de-vencimentos.mdx

Todos os contratos do mesmo ativo, com o último ajuste por vencimento. Útil para curva de juros do DI, contratos de commodities ou mini Ibov.

***

title: Curva de Vencimentos
description: >-
Todos os contratos do mesmo ativo, com o último ajuste por vencimento.
Útil para curva de juros do DI, contratos de commodities ou mini Ibov.
full: true
keywords: brapi, api, futuros, curva, term structure, vencimento, DI, contango
openGraph:
title: Curva de Vencimentos de Futuros
description: >-
Todos os contratos do mesmo ativo com o último ajuste por vencimento.
type: website
locale: pt\_BR
lastUpdated: '2026-05-21T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/futures/term-structure
structuredData:
headings: \[]
contents:

* content: >-
  Todos os contratos do mesmo ativo, com o último ajuste por
  vencimento. Útil para curva de juros, contratos de commodities
  ou mini Ibov.

***

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

Retorna **todos os contratos do mesmo ativo**, ordenados pelo vencimento
mais próximo. Cada contrato vem com a cotação do último pregão.

Bons usos:

* **Curva de juros do DI:** `asset=DI1` traz todos os vencimentos com a
  taxa de ajuste (`settlementRate`) por mês.
* **Curva do mini Ibov:** `asset=WIN` mostra como o mercado precifica o
  índice para datas futuras.
* **Preço de commodities ao longo do tempo:** `asset=BGI` (boi), `ICF`
  (café), `CCM` (milho) ou `SJC` (soja).

<Callout type="info">
  Em contratos cotados em taxa (DI, DAP), use `close` e `settlementRate`
  para a curva de juros. Em contratos em preço (WIN, BGI etc.), use
  `close` ou `settlement`.
</Callout>

<Callout type="info">
  **Plano Pro.** Sem token, aceita só `asset=WIN` ou `asset=WDO`.
</Callout>





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/term-structure

Single endpoint documentation for /api/v2/futures/term-structure

## Base URLs

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

## GET /api/v2/futures/term-structure

**Summary:** Curva de vencimentos

Retorna todos os contratos do mesmo ativo, com o último pregão de cada um, do vencimento mais próximo para o mais distante.

**Tags:** Futuros

### Parameters

- **asset** (query) *required*
- **includeExpired** (query)

### Responses

#### 200

Curva de vencimentos.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

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


### FutureQuote

**Properties:**

- **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** (string) - Options: `financial`, `agribusiness` *(required)*
  `financial` = índices, juros e moeda. `agribusiness` = commodities.

- **quotationType** (string) - Options: `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.

- **date** (integer) *(required)*
  Data do pregão (Unix em segundos).

- **open** (number) *(nullable)* *(required)*
  Preço de abertura. Vem `null` — o arquivo do fim do dia não publica abertura.

- **high** (number) *(nullable)* *(required)*
  Máxima do dia (taxa em %a.a. para DI; preço para os demais).

- **low** (number) *(nullable)* *(required)*
  Mínima do dia (taxa em %a.a. para DI; preço para os demais).

- **average** (number) *(nullable)* *(required)*
  Preço médio do dia.

- **close** (number) *(nullable)* *(required)*
  Preço de fechamento (último negócio). Em DI e DAP, vem em %a.a.

- **settlement** (number) *(nullable)* *(required)*
  Preço de ajuste oficial do dia. Em juros, vem em reais; nos demais, em preço.

- **settlementRate** (number) *(nullable)* *(required)*
  Taxa de ajuste. Só vem em contratos de juros (DI, DAP).

- **referencePrice** (number) *(nullable)* *(required)*
  Preço de referência oficial.

- **oscillationPct** (number) *(nullable)* *(required)*
  Variação % em relação ao dia anterior.

- **trades** (number) *(nullable)* *(required)*
  Número de negócios.

- **volume** (number) *(nullable)* *(required)*
  Quantidade de contratos negociados.

- **financialVolume** (number) *(nullable)* *(required)*
  Volume em reais (BRL).


### FutureTermStructureResponse

**Properties:**

- **asset** (string) *(required)*

- **contracts** (array) *(required)*
  Array items:
    Reference to: **FutureQuote**

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

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