DataBolsa docs
Referência da APIDados de mercadoCrédito privado

Quais fundos detêm um papel de crédito privado, e quanto

A visão reversa da carteira: dado o ISIN de um CRI, CRA ou debênture, quais classes de fundo carregam o papel e com que valor a mercado, na competência do CDA. **O número é PISO, nunca total, e por dois motivos independentes.** Primeiro, o CDA não publica ISIN nos blocos de crédito privado: a posição só aparece aqui quando a identidade do papel foi resolvida a partir do que a fonte descreve (`match_level` `cetip` ou `issuer_maturity`). A mesma emissão pode estar em outros fundos que a descreveram de forma pobre demais para resolver, e essas posições existem em `/v1/funds/{cnpj}/credit-holdings` sem aparecer nesta lista. Segundo, o CDA cobre **fundo**: FII reporta por outro canal, e banco, seguradora, tesouraria e pessoa física não reportam carteira. `summary.resolved_only` é sempre `true` para que essa leitura não dependa de ninguém ter lido esta descrição. Para a exposição que NÃO depende de resolver o papel, consulte por emissor: a posição em `match_level: issuer` sabe qual casa emitiu mesmo sem saber qual série. Papel sem nenhuma posição resolvida responde página vazia com `summary` nulo — o que significa 'não sabemos de nenhuma', não 'nenhum fundo detém'.

GET
/v1/credit/securities/{isin}/fund-holders
AuthorizationBearer <token>

In: header

Path Parameters

isinstring

Query Parameters

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

Competência do CDA (AAAA-MM-DD); default = a mais recente com posição neste papel.

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

Response Body

curl -X GET "https://api.databolsa.com/v1/credit/securities/string/fund-holders?cursor=string&limit=100&date=string"
{
  "data": [
    {
      "cnpj": "string",
      "comptc_date": "string",
      "source_block": "string",
      "asset_family": "string",
      "tp_aplic": "string",
      "tp_ativo": "string",
      "ds_ativo": "string",
      "cetip_code": "string",
      "isin": "string",
      "debenture_code": "string",
      "match_level": "cetip",
      "issuer_name": "string",
      "issuer_doc": "string",
      "issuer_person_type": "string",
      "issuer_related": "string",
      "maturity_date": "string",
      "indexer_label": "string",
      "indexer_pct": 0,
      "prefixed_rate_pct": 0,
      "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"
    },
    "summary": {
      "isin": "string",
      "comptc_date": "string",
      "n_funds": 0,
      "total_value_brl": 0,
      "resolved_only": true
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Quem é o CNPJ que originou o recebível

O informe mensal publica o **documento** do cedente e mais nada — sem razão social, sem situação cadastral, sem porte. É o único lugar em que esses CNPJs aparecem de graça, e é também onde a trilha pública terminava. Esta rota é a continuação dela: identidade, atividade, localização e situação cadastral pelo cadastro federal. `situacao_adversa` é **sinal, não sentença**: inapta costuma ser quem parou de entregar declaração e baixada pode ser reorganização societária normal. Serve como pergunta a fazer, não como veredito sobre a empresa. `capital_social` é **declarado e não auditado** — a empresa escreve, ninguém confere. Vale como ordem de grandeza e como sinal de mudança entre competências, nunca como patrimônio. `encontrado_no_cadastro` existe porque "não sabemos" e "achamos" são conclusões opostas. **Cedente pessoa física não é consultável**: a fonte publica CPF mascarado, então não existe cruzamento possível. O universo aqui é o dos cedentes declarados no informe — CNPJ fora dele responde 404.

Histórico de ações de rating de um papel ou emissor

Todas as ações observadas, append-only: um rating é evento datado, não atributo mutável — 'a Fitch atribuiu AA+ em 12/03/2025' continua verdade depois de um rebaixamento em 2026. Exige `assetCode` (ISIN) ou `issuerCnpj`. `superseded_by` preenchido marca a linha corrigida: correção cria linha nova em vez de editar o fato, e a linha antiga fica como trilha de auditoria. `extracted_at` é quando nós soubemos; `action_date` é quando a agência agiu — as duas datas são distintas de propósito.