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:
asset=DI1 traz todos os vencimentos com a
taxa de ajuste (settlementRate) por mês.asset=WIN mostra como o mercado precifica o
índice para datas futuras.asset=BGI (boi), ICF
(café), CCM (milho) ou SJC (soja).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.
Plano Pro. Sem token, aceita só asset=WIN ou asset=WDO.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Código do ativo (ex.: BGI, WIN, DI1).
true inclui contratos vencidos. Padrão: false.
"false"Value in
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/futures/term-structure?asset=BGI"{ "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}