BRbrapi-dev
Futuros

Curva de vencimentos

Changed on

Todos os contratos futuros de um ativo com vencimento a partir de hoje, do mais próximo ao mais distante, cada um com os dados do último pregão.

Use para montar a curva de juros do DI, ver a curva de preço de commodities ou comparar vencimentos do mini Ibovespa.

Em DI1, a taxa de cada prazo fica em settlementRate. Nos contratos cotados em preço, use settlement. Com includeExpired=true, a resposta inclui contratos vencidos.

Ativos comuns: DI1 (DI), WIN (mini Ibovespa), WDO (mini dólar), BGI (boi gordo), ICF (café), CCM (milho) e SJC (soja).

Plano Pro. Sem token, aceita só asset=WIN ou asset=WDO.

get/api/v2/futures/term-structure

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/futures/term-structure
  • Auth
    HTTP bearer

Query parameters

assetstring required

Código do ativo. Ex.: DI1, WIN, BGI.

Example:BGI
includeExpired'true' | 'false'

true inclui contratos vencidos.

Response

Curva de vencimentos.

assetstring required
requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "asset": "DI1",
  "contracts": [
    {
      "symbol": "DI1M26",
      "underlyingAsset": "DI1",
      "assetDescription": "Taxa Média de Depósitos Interfinanceiros de Um Dia",
      "segment": "financial",
      "quotationType": "rate",
      "expirationDate": "2026-06-01",
      "firstTradeDate": "2015-12-28",
      "lastTradeDate": "2026-05-29",
      "contractMultiplier": 1,
      "allocationRoundLot": 1,
      "tradingCurrency": "BRL",
      "deliveryType": "Financial",
      "exerciseType": "Rate",
      "isin": "BRBMEFD1I4M0",
      "cficCode": "FFNCSX",
      "date": 1779235200,
      "open": null,
      "high": 14.41,
      "low": 14.39,
      "average": 14.4,
      "close": 14.398,
      "settlement": 98884.51,
      "settlementRate": 14.4,
      "referencePrice": null,
      "oscillationPct": -0.02,
      "trades": 12345,
      "volume": 234567,
      "financialVolume": 23194840000
    },
    {
      "symbol": "DI1F27",
      "underlyingAsset": "DI1",
      "assetDescription": "Taxa Média de Depósitos Interfinanceiros de Um Dia",
      "segment": "financial",
      "quotationType": "rate",
      "expirationDate": "2027-01-04",
      "firstTradeDate": "2015-12-28",
      "lastTradeDate": "2026-12-30",
      "contractMultiplier": 1,
      "allocationRoundLot": 1,
      "tradingCurrency": "BRL",
      "deliveryType": "Financial",
      "exerciseType": "Rate",
      "isin": "BRBMEFD1I4Z0",
      "cficCode": "FFNCSX",
      "date": 1779235200,
      "open": null,
      "high": 14.16,
      "low": 14.03,
      "average": 14.09,
      "close": 14.075,
      "settlement": 92179.44,
      "settlementRate": 14.059,
      "referencePrice": null,
      "oscillationPct": -0.51,
      "trades": 28694,
      "volume": 850519,
      "financialVolume": 78386932604.68
    }
  ],
  "requestedAt": "2026-05-21T03:00:00.000Z",
  "took": 137
}

Changes