Futuros
Curva de Vencimentos
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=DI1traz todos os vencimentos com a taxa de ajuste (settlementRate) por mês. - Curva do mini Ibov:
asset=WINmostra como o mercado precifica o índice para datas futuras. - Preço de commodities ao longo do tempo:
asset=BGI(boi),ICF(café),CCM(milho) ouSJC(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.
Authorization
Bearer AuthorizationBearer <token>
Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
asset*string
Código do ativo (ex.: BGI, WIN, DI1).
includeExpired?string
true inclui contratos vencidos. Padrão: false.
Default
"false"Value in
"true" | "false"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/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
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}