BRbrapi-dev
Futuros

Histórico de futuros

Changed on

Série diária de um contrato futuro: máxima, mínima, fechamento, preço de ajuste, taxa de ajuste em contratos de juros, variação e volume.

Use para gráficos, backtests ou para estudar o ajuste diário de um vencimento.

Sem startDate, a série começa 12 meses antes de hoje. Sem endDate, termina hoje. O histórico cobre cerca de 1 ano. open vem sempre null, porque os dados de fim de dia não trazem abertura.

A série termina no vencimento do contrato. Para seguir um ativo por mais tempo, junte contratos seguidos e trate o salto de preço na troca. Para vários contratos, use a cotação ou a curva de vencimentos.

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

get/api/v2/futures/historical

Request

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

Query parameters

symbolstring required

Código do contrato. Ex.: WINM26.

Example:WINM26
startDatestring

Data inicial no formato YYYY-MM-DD. Padrão: 12 meses antes de hoje.

endDatestring

Data final no formato YYYY-MM-DD. Padrão: hoje.

sortOrder'asc' | 'desc'

Ordem das datas. desc traz o pregão mais recente primeiro.

Response

Histórico.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "future": {
    "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",
    "history": [
      {
        "date": 1779235200,
        "open": null,
        "high": 179945,
        "low": 176180,
        "average": 178583,
        "close": 178650,
        "settlement": 179115,
        "settlementRate": null,
        "referencePrice": null,
        "oscillationPct": 1.59,
        "trades": 4906603,
        "volume": 17533842,
        "financialVolume": 626250384171
      },
      {
        "date": 1779148800,
        "open": null,
        "high": 178700,
        "low": 175200,
        "average": 176509,
        "close": 176465,
        "settlement": 175844,
        "settlementRate": null,
        "referencePrice": null,
        "oscillationPct": -1.46,
        "trades": 5563064,
        "volume": 20252108,
        "financialVolume": 714936160000
      }
    ]
  },
  "requestedAt": "2026-05-21T03:00:00.000Z",
  "took": 65
}

Changes