Futuros
Especificações de Futuros
Retorna só os dados do contrato — sem preço, volume ou ajuste. Use quando precisar só das características fixas (multiplicador, lote, vencimento).
Campos:
contractMultiplier: quanto vale cada ponto. Ex.:WIN = 0,2,WDO = 10,BGI = 330.allocationRoundLot: tamanho do lote (quase sempre1).expirationDate,firstTradeDate,lastTradeDate: datas do contrato.quotationType:price(maioria) ourate(DI, DAP).isin,cficCode: códigos padronizados.deliveryType,exerciseType,tradingCurrency: regras de liquidação.companyName: emissor, quando existir.
Para a cotação do dia, use
/api/v2/futures/quote.
Plano Pro. Sem token, aceita só symbols= começando com WIN ou
WDO.
Authorization
Bearer AuthorizationBearer <token>
Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
symbols*string
Contratos separados por vírgula (máx. 20).
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/futures/specs?symbols=WINM26%2CBGIF27%2CDI1F27"{
"specs": [
{
"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": "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"
}
],
"requestedAt": "2026-05-21T03:00:00.000Z",
"took": 12
}{
"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"
}