BRbrapi-dev
Futuros

Especificações de futuros

Changed on

Dados fixos de até 20 contratos futuros, sem preço: vencimento, primeiro e último pregão, multiplicador, lote, tipo de entrega, ISIN e código CFI.

Use para calcular o valor financeiro de uma posição, conferir vencimentos ou cadastrar contratos no seu sistema.

contractMultiplier converte pontos em reais. Exemplos: WIN vale 0,2 por ponto, WDO vale 10 e BGI vale 330. Para o preço do dia, use a cotação de futuros.

Plano Pro. Sem token, aceita só symbols que começam com WIN ou WDO.

get/api/v2/futures/specs

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/futures/specs
  • Auth
    HTTP bearer

Query parameters

symbolsstring required

Contratos separados por vírgula, até 20. Ex.: WINM26,DI1F27.

Example:WINM26,BGIF27,DI1F27

Response

Especificações.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "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
}

Changes