BRbrapi-dev
Futuros

Lista de contratos futuros

Changed on

Contratos futuros com vencimento, multiplicador, lote e ISIN, sem preço. Filtre por ativo, segmento e contratos vencidos.

Use para achar o código exato de um contrato, listar os vencimentos de um ativo ou montar um seletor de contratos.

Um ativo tem vários contratos ao mesmo tempo, um por vencimento. WINJ26 e WINM26 são o mesmo mini Ibovespa em meses diferentes. Veja como ler o código em futuros.

Por padrão, a lista traz só contratos com vencimento a partir de hoje. Plano Pro. Sem token, aceita só asset=WIN ou asset=WDO.

get/api/v2/futures/list

Request

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

Query parameters

assetstring

Código do ativo. Ex.: WIN, BGI, DI1.

Example:BGI
segment'financial' | 'agribusiness'

Segmento do contrato.

includeExpired'true' | 'false'

true inclui contratos vencidos.

pageinteger

Número da página, a partir de 1.

limitinteger

Itens por página. Máximo: 100.

sortBy'symbol' | 'expirationDate' | 'underlyingAsset'

Campo usado na ordenação.

sortOrder'asc' | 'desc'

Direção da ordenação.

Response

Lista de contratos.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

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

Changes