Fundos

Fundos que têm um ativo

Fundos que carregam um ativo na carteira, com valor e participação no patrimônio de cada um.

GEThttps://api.fintay.com.br/v1/assets/{series_id}/fund-holders

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de rota

series_idstring · uuidobrigatório

Identificador da série do ativo (ex.: o de b3/PETR4).

Parâmetros de consulta

competencestring · date

Mês da carteira. Padrão: o mais recente.

limitintegerpadrão: 50mín. 1 · máx. 200

Máximo de fundos.

offsetintegerpadrão: 0mín. 0

Fundos a pular.

Resposta

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

class_idstring

Exemplo: 6138ebe8-8a03-4e32-bd79-4423994e9ce3

cnpj_fundostring

Exemplo: 08771962000156

cnpj_classestring

Exemplo: 08771962000156

namestring

Exemplo: OITI FIF MULTIMERCADO CRÉDITO PRIVADO INVESTIMENTO NO EXTERI

gestorstring

Exemplo: ITAU UNIBANCO S.A.

long_valuenumber

Exemplo: 1287710976.74

lent_valuenull

short_valuenumber

Exemplo: 1865509857.16

plnumber

Exemplo: 33934150456.12

pct_pl_longnumber

Exemplo: 3.7947346830006237

pct_pl_shortnumber

Exemplo: 5.4974408732355835

GETFundos que têm um ativo

curl "https://api.fintay.com.br/v1/assets/34f27cc6-1076-46c0-aeb7-b5e85499b799/fund-holders?limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "ticker": "PETR4",
    "competence": "2026-08-01",
    "competences": [
      "2026-08-01"
    ],
    "summary": {
      "total_holders": 309,
      "long_holders": 289,
      "long_total": 7325998572.54,
      "short_holders": 27,
      "short_total": 2517643952.17
    },
    "items": [
      {
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "cnpj_fundo": "08771962000156",
        "cnpj_classe": "08771962000156",
        "name": "OITI FIF MULTIMERCADO CRÉDITO PRIVADO INVESTIMENTO NO EXTERIOR RESPONSABILIDADE LIMITADA",
        "gestor": "ITAU UNIBANCO S.A.",
        "long_value": 1287710976.74,
        "lent_value": null,
        "short_value": 1865509857.16,
        "pl": 33934150456.12,
        "pct_pl_long": 3.7947346830006237,
        "pct_pl_short": 5.4974408732355835
      },
      {
        "class_id": "2a65aa80-d6b9-4724-b593-49112824d4eb",
        "cnpj_fundo": "08935128000159",
        "cnpj_classe": "08935128000159",
        "name": "GERAÇÃO L. PAR FUNDO DE INVESTIMENTO FINANCEIRO DE AÇÕES DE RESPONSABILIDADE LIMITADA",
        "gestor": "PLURAL INVESTIMENTOS GESTÃO DE RECURSOS LTDA.",
        "long_value": 1170520000,
        "lent_value": 270838744.3,
        "short_value": null,
        "pl": 6114104294.75,
        "pct_pl_long": 19.144586738651004,
        "pct_pl_short": null
      },
      {
        "class_id": "76be3ac4-3462-4d3d-ad0f-077ba65b15d7",
        "cnpj_fundo": "09625909000100",
        "cnpj_classe": "09625909000100",
        "name": "ARTESANAL D+2 FUNDO DE INVESTIMENTO MULTIMERCADO",
        "gestor": "ARTESANAL INVESTIMENTOS LTDA",
        "long_value": 1062724112,
        "lent_value": null,
        "short_value": null,
        "pl": 3535997837.24,
        "pct_pl_long": 30.054433314628447,
        "pct_pl_short": null
      }
    ],
    "has_more": true,
    "offset": 0
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}