Ações e índices

Carteira teórica de um índice

Ativos e pesos da carteira teórica de um índice da B3 numa data.

GEThttps://api.fintay.com.br/v1/b3/index-composition/{code}

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de rota

codestringobrigatório

Código do índice na B3 (ex.: IBOV, SMLL, IDIV).

Parâmetros de consulta

onstring · date

Data da carteira. Padrão: a mais recente.

Resposta

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

tickerstring

Exemplo: VALE3

asset_namestring

Exemplo: VALE

share_typestring

Exemplo: ON NM

theoretical_qtyinteger

Exemplo: 3687404862

weight_pctnumber

Exemplo: 9.877

series_idstring

Exemplo: 92ca7ed4-821f-43b8-9838-37b8bc1ab198

sectorstring

Exemplo: Extração Mineral

GETCarteira teórica de um índice

curl "https://api.fintay.com.br/v1/b3/index-composition/IBOV" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "index": "IBOV",
    "reference_date": "2026-10-05",
    "previous_date": null,
    "items": [
      {
        "ticker": "VALE3",
        "asset_name": "VALE",
        "share_type": "ON NM",
        "theoretical_qty": 3687404862,
        "weight_pct": 9.877,
        "series_id": "92ca7ed4-821f-43b8-9838-37b8bc1ab198",
        "sector": "Extração Mineral"
      },
      {
        "ticker": "ITUB4",
        "asset_name": "ITAUUNIBANCO",
        "share_type": "PN EJ N1",
        "theoretical_qty": 5337898685,
        "weight_pct": 8.89,
        "series_id": "477a0e3d-fd0d-42cb-b33d-ea9c0c04e9e5",
        "sector": "Bancos"
      },
      {
        "ticker": "PETR4",
        "asset_name": "PETROBRAS",
        "share_type": "PN N2",
        "theoretical_qty": 4410957710,
        "weight_pct": 8.385,
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "sector": "Petróleo e Gás"
      }
    ],
    "entered": [],
    "left": [],
    "sectors": [
      {
        "sector": "Bancos",
        "weight_pct": 19.257
      },
      {
        "sector": "Petróleo e Gás",
        "weight_pct": 15.48
      },
      {
        "sector": "Extração Mineral",
        "weight_pct": 9.877
      }
    ],
    "concentration_top10": 54.153
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}