Histórico de Futuros
Retorna a série diária de um contrato, pelo symbol. Para vários
contratos de uma vez, use
/api/v2/futures/quote (até 20).
Cada dia traz:
- OHLC (
open,high,low,close,average). - Preço de ajuste (
settlement): o preço oficial do dia. - Taxa de ajuste (
settlementRate): só em DI e DAP. referencePrice: preço de referência oficial.oscillationPct: variação % do dia anterior.- Volume:
trades,volume(contratos),financialVolume(em reais).
Em DI e DAP, close vem em taxa (%a.a.) e settlement em reais. Veja
quotationType no nível do contrato — vale para a série toda.
O campo open vem null em futuros — o arquivo do fim do dia não
publica abertura. Em contratos com pouca negociação, OHLC pode vir todo
null; nesses dias, settlement ainda vem preenchido.
Plano Pro. Sem token, aceita só symbol começando com WIN ou
WDO.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
Código do contrato (ex.: WINM26).
Data inicial (YYYY-MM-DD). Padrão: 12 meses atrás.
Data final (YYYY-MM-DD). Padrão: hoje.
"desc""asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/futures/historical?symbol=WINM26"{
"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
}{
"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": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}