Use a API de futuros para consultar contratos listados na B3, montar curvas de vencimento, buscar preço de ajuste e baixar histórico diário.
O caminho normal é:
WIN, BGI, DI1)Dados disponíveis
Dados EOD após o fechamento do pregão: abertura, máxima, mínima, fechamento, preço de ajuste, variação do dia, negócios, contratos e volume financeiro. Para DI e DAP, a resposta também traz a taxa de ajuste.
WIN), Ibov (IND), mini dólar (WDO),
dólar (DOL), DI (DI1), boi (BGI), café (ICF), milho (CCM),
soja (SJC) e outros.America/Sao_Paulo. Em histórico de preços, date é um
número (Unix em segundos) com a data do fechamento. Em analytics de opções,
date vem em YYYY-MM-DD.YYYY-MM-DD.Futuros estão no plano Pro. Sem token, dá para testar com WIN (mini Ibov) e WDO (mini Dolar).
| Plano | Acesso |
|---|---|
| Sem token (sandbox) | WIN e WDO |
| Free | Não incluso |
| Startup | Não incluso |
| Pro | Todos os contratos |
underlyingAsset ou asset): o código de 2 a 4 letras do
produto, sem mês ou ano. Ex.: WIN, WDO, BGI, DI1.symbol): o código que o mercado negocia. Formato:
{ATIVO}{LETRA_MÊS}{ANO}. Ex.: WINM26 = mini Ibov com vencimento em
junho de 2026.expirationDate): data em que o contrato termina, no
formato YYYY-MM-DD.settlement): o preço oficial do dia, divulgado no
fim do pregão. Vem sempre preenchido, mesmo em dias sem negócio.settlementRate): só vem em contratos de juros
(DI, DAP). É a taxa anual (%a.a.) do ajuste.contractMultiplier): quanto vale cada ponto.
Ex.: WIN = 0,2, WDO = 10, BGI = 330 (arrobas), DI1 = 1.allocationRoundLot): tamanho do lote. Quase sempre 1.quotationType): price para a maioria,
rate para juros (DI, DAP). Veja abaixo.A maioria dos futuros é cotada em preço. O número em close, high,
low e settlement é o preço direto (pontos para WIN, reais para BGI etc.).
Os futuros de juros (DI1, DI, DAP) são cotados em taxa anual
(%a.a.):
close, high, low, average vêm em %a.a. (ex.: 14.075 =
14,075% a.a.).settlement vem em reais (preço unitário, ex.: 92179.44).settlementRate vem em %a.a. (ex.: 14.059).O campo quotationType ("price" ou "rate") na resposta diz qual
unidade usar.
Para o preço oficial do dia, use sempre settlement. O close
(último negócio) pode vir vazio em contratos com pouca negociação.
symbolPadrão: {ATIVO}{LETRA_MÊS}{ANO}.
WIN, WDO, BGI, DI1).| Mês | Letra | Mês | Letra |
|---|---|---|---|
| Janeiro | F | Julho | N |
| Fevereiro | G | Agosto | Q |
| Março | H | Setembro | U |
| Abril | J | Outubro | V |
| Maio | K | Novembro | X |
| Junho | M | Dezembro | Z |
Exemplos:
WINM26 → mini Ibov, junho de 2026.DI1F27 → DI, janeiro de 2027.BGIK26 → boi gordo, maio de 2026.Exemplo do fluxo curva → cotação → histórico para o mini Ibov.
# 1) Curva de vencimentos do mini Ibov
curl "https://brapi.dev/api/v2/futures/term-structure?asset=WIN"
# 2) Cotação do contrato
curl "https://brapi.dev/api/v2/futures/quote?symbols=WINM26"
# 3) Histórico dos últimos 12 meses
curl "https://brapi.dev/api/v2/futures/historical?symbol=WINM26"Use /api/v2/futures/list para ver o que existe,
ou /api/v2/futures/term-structure
para ver todos os vencimentos de um ativo.
Use /api/v2/futures/quote para a cotação do
dia de até 20 contratos, ou
/api/v2/futures/specs para os dados do
contrato (multiplicador, lote, vencimento, ISIN).
Use /api/v2/futures/historical com symbol
para a série diária do contrato.
Para opções sobre futuros (boi, café, milho, soja), veja Opções sobre Futuros.
list → quoteterm-structure?asset=DI1term-structure?asset=WINterm-structure?asset=BGI → historicalquote (use settlement e settlementRate)Para testar sem token, os endpoints aceitam só estes ativos:
/list, /term-structure: asset=WIN ou asset=WDO./quote, /specs: symbols= com WIN ou WDO./historical: symbol com WIN ou WDO./options/expirations, /options/strikes, /options/chain:
underlying=BGI./options/historical: symbol com BGI.Para outros ativos, use um token do plano Pro.
Lista de futuros com filtro por ativo e segmento.
Cotação do dia para até 20 contratos.
Multiplicador, lote, vencimento, ISIN, CFI.
Série diária de um contrato com OHLC + ajuste.
Todos os vencimentos de um ativo com o último ajuste.
Opções sobre boi, café, milho, soja e outros.