Câmbio, cripto e derivativos

Estrutura a termo de um futuro

Ajuste, volume e contratos em aberto de cada vencimento de um contrato futuro da B3 num pregão.

GEThttps://api.fintay.com.br/v1/futures/{underlying}/term-structure

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

underlyingstringobrigatório

Ativo do contrato (ex.: DI1, DOL, IND).

Parâmetros de consulta

as_ofstring · date

Pregão. Padrão: o mais recente.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

source_keystring

Exemplo: futures:DOLX26

expiration_datestring

Exemplo: 2026-11-03

multiplierinteger

Exemplo: 50

quotation_typestring

Exemplo: price

observed_atstring

Exemplo: 2026-09-25T00:00:00+00:00

currencystring

Exemplo: BRL

closeinteger

Exemplo: 5228

settlementnumber

Exemplo: 5223.236

settlement_ratenull

volumeinteger

Exemplo: 1240

GETEstrutura a termo de um futuro

curl "https://api.fintay.com.br/v1/futures/DOL/term-structure" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "source_key": "futures:DOLX26",
        "expiration_date": "2026-11-03",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": 5228,
        "settlement": 5223.236,
        "settlement_rate": null,
        "volume": 1240
      },
      {
        "source_key": "futures:DOLZ26",
        "expiration_date": "2026-12-01",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": null,
        "settlement": 5251.423,
        "settlement_rate": null,
        "volume": null
      },
      {
        "source_key": "futures:DOLF27",
        "expiration_date": "2027-01-04",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": null,
        "settlement": 5280.528,
        "settlement_rate": null,
        "volume": null
      }
    ],
    "note": "Última observação disponível por contrato; sem série contínua ou interpolação."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}