DataBolsa docs
Referência da APIDados de mercadoFundos

Carteira (holdings) de um fundo

Posições do fundo (BLC_4 do CDA): ações, BDR, opções e debêntures com valor a mercado. Competência mais recente por default; use `date` (AAAA-MM-DD) p/ outra.

GET
/v1/funds/{cnpj}/holdings
AuthorizationBearer <token>

In: header

Path Parameters

cnpjstring

Query Parameters

cursor?string
limit?integer
Default100
Range1 <= value <= 1000
date?string

Competência (AAAA-MM-DD); default = mais recente.

Match^\d{4}-\d{2}-\d{2}$

Response Body

curl -X GET "https://api.databolsa.com/v1/funds/string/holdings?cursor=string&limit=100&date=string"
{
  "data": [
    {
      "cnpj": "string",
      "comptc_date": "string",
      "cd_ativo": "string",
      "ticker": "string",
      "tp_aplic": "string",
      "ds_ativo": "string",
      "cd_isin": "string",
      "qty": 0,
      "market_value": 0,
      "fund_name": "string",
      "fund_manager": "string",
      "fund_classificacao": "string"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}

Crédito privado na carteira do fundo (CRI, CRA, CCB, nota promissória)

As posições de crédito privado que a carteira codificada não mostra. `/holdings` cobre o BLC_4 do CDA, onde o papel tem código de negociação; esta rota cobre os blocos BLC_6 e BLC_8, onde o papel se identifica pelo **emissor**: CRI, CRA, CCB, CCI, CPR, CDCA, NCA, LCA, nota promissória e as debêntures sem código de negociação — que sozinhas são a maior fatia. **`match_level` é a coluna que sustenta a leitura de todas as outras.** O CDA não publica ISIN nestes blocos: o CRI vem descrito em texto livre e o CRA por (emissor, vencimento, indexador). O campo diz até onde a resolução de identidade chegou — `cetip` e `issuer_maturity` trazem `isin`; `issuer` resolve só a casa emissora; `none` não amarra em cadastro nenhum. Filtrar por `isin` não nulo devolve um recorte, nunca a carteira: somar `market_value` sem filtro é o que dá a exposição completa. Órfão não é falha de busca. Nota promissória e CCB **não têm cadastro público de série** — são dívida direta e contrato bilateral — e por construção nunca terão ISIN aqui. Em 2026-06 as duas famílias são 82% do valor sem match. Carteira sem crédito privado responde página vazia, que é o caso comum. Competência mais recente por default; use `date` p/ outra.

Fundos que detêm cotas deste fundo (visão reversa)

A mesma aresta de `listInvestedFunds` lida do outro lado: quais fundos aplicam NESTA classe e quanto. Serve para ver de onde vem o passivo de um fundo — quanto do PL está em mãos de outros fundos do mesmo grupo, e o que uma retirada concentrada representaria. `investor_share_pct` diz quanto a posição pesa no PL de quem investiu.