Futuros
Listar Contratos Futuros
Retorna a lista de contratos futuros. Use os filtros para limitar a um
ativo (ex.: asset=BGI) ou a um segmento (ex.: segment=agribusiness).
Cada item traz os dados do contrato (sem preço): símbolo, ativo,
vencimento, multiplicador, lote, ISIN, CFI. Para a cotação do dia, use
/api/v2/futures/quote. Para a curva inteira de
um ativo, use
/api/v2/futures/term-structure.
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
Filtra por código do ativo (ex.: WIN, BGI, DI1).
segment?string
Filtra por segmento.
Value in
"financial" | "agribusiness"includeExpired?string
true inclui contratos vencidos. Padrão: false.
Default
"false"Value in
"true" | "false"page?integer
Número da página (começa em 1).
Default
1Range
1 <= valuelimit?integer
Itens por página (máx. 100).
Default
50Range
1 <= value <= 100sortBy?string
Default
"expirationDate"Value in
"symbol" | "expirationDate" | "underlyingAsset"sortOrder?string
Default
"asc"Value in
"asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/futures/list"{
"futures": [
{
"symbol": "WINM26",
"underlyingAsset": "WIN",
"assetDescription": "Minicontrato de Ibovespa",
"segment": "financial",
"quotationType": "price",
"expirationDate": "2026-06-17",
"firstTradeDate": "2024-04-29",
"lastTradeDate": "2026-06-17",
"contractMultiplier": 0.2,
"allocationRoundLot": 1,
"tradingCurrency": "BRL",
"deliveryType": "Financial",
"exerciseType": "Price",
"isin": "BRBMEFWIN3O3",
"cficCode": "FFICSX"
},
{
"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"
},
{
"symbol": "BGIF27",
"underlyingAsset": "BGI",
"assetDescription": "Boi Gordo",
"segment": "agribusiness",
"quotationType": "price",
"expirationDate": "2027-01-29",
"firstTradeDate": "2026-02-27",
"lastTradeDate": "2027-01-29",
"contractMultiplier": 330,
"allocationRoundLot": 1,
"tradingCurrency": "BRL",
"deliveryType": "Financial",
"exerciseType": "Price",
"isin": "BRBMEFBGI7Y7",
"cficCode": "FCACSX"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1728,
"totalPages": 35
},
"requestedAt": "2026-05-21T03:00:00.000Z",
"took": 42
}{
"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"
}