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

Mix de risco SCR da carteira (Res. CMN 2.682) — não é rating de agência

Distribuição da carteira pelos níveis **SCR** da Resolução CMN 2.682 (AA a H), atribuídos pela própria instituição ao devedor e à operação. **Isto não é rating de agência classificadora e não é comparável com `brAAA`.** As duas escalas usam letras, e confundi-las é o erro que este endpoint mais convida a cometer — o rating de agência vive em `/credit/ratings`. `declares_scr: false` significa que a classe não declarou nível nenhum, o que é diferente de declarar zero numa faixa: menos da metade das classes preenche, e mostrar 0% para quem não declarou seria inventar dado. A série começa em 2023 — a tabela só passa a existir no informe depois da reforma de classes.

GET
/v1/credit/fidc/{cnpj}/scr
AuthorizationBearer <token>

In: header

Path Parameters

cnpjstring

CNPJ completo do emissor, 14 dígitos sem pontuação.

Match^\d{14}$

Query Parameters

date?string

Competência exata (fim de mês). Default: a mais recente.

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

Response Body

curl -X GET "https://api.databolsa.com/v1/credit/fidc/string/scr?date=string"
{
  "data": [
    {
      "cnpj": "string",
      "reference_date": "string",
      "scr_level": "string",
      "scr_order": 0,
      "amount_debtor": 0,
      "amount_operation": 0,
      "pct_debtor": 0,
      "pct_operation": 0,
      "total_debtor": 0,
      "total_operation": 0,
      "declares_scr": true
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    },
    "cnpj": "string",
    "reference_date": "string"
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Classes de FIDC por competência: patrimônio, carteira e inadimplência

Fundos de direitos creditórios do informe mensal da CVM. O FIDC tem superfície própria e não aparece nas séries de `/funds` porque sua cota é marcada a **laudo** e não passa pelo informe diário — servi-lo por lá devolveria fundo sem série. A chave é a **classe**, não o fundo: um fundo multiclasse tem um CNPJ por classe, e as classes têm prioridades diferentes. `entity_kind` vem null nas competências anteriores a 2020-11, quando a fonte publicava o CNPJ do fundo e o grão era outro — é o marcador da era, não uma lacuna. As duas séries de inadimplência **não se somam**: em `*_with_risk` o cedente responde pelo crédito, em `*_no_risk` o fundo carrega a perda. `impaired_ratio` é fração da **carteira** (não do patrimônio) e vem null quando o inadimplente declarado excede a carteira — nesse caso `impaired_exceeds_portfolio` é true e os componentes brutos continuam na resposta. `overdue_*` (vencido e não pago) e `impaired_*` (reconhecido como inadimplente) também são rubricas distintas e nunca substituem uma à outra. Um FIDC feeder pode declarar recebíveis diretos e inadimplência iguais a zero porque carrega cotas de outros FIDCs. Isso significa risco em outra camada, não ausência de risco; `/funds/:cnpj/holdings` e `/funds/:cnpj/invested-funds` cobrem fundos ordinários e podem vir vazios nesse caso. Sem `date`, serve a competência mais recente com dado. **Os filtros daqui são de CADASTRO e tamanho** (`cnpj`, `q`, `minNetWorth`). Para cortar por uma MEDIDA — grande E inadimplente, inadimplência acima de um limiar, os N maiores de um recorte — use `rankObjects` / `aggregateObjects` com `where`: é uma chamada, contra paginar as 4.208 classes e calcular do lado de fora. Atenção à escala ao compor: `impaired_ratio` é FRAÇÃO (0,05 = 5%) e `top_originator_pct` é PERCENTUAL (35,2 = 35,2%).

Carteira do FIDC por setor do lastro

Do que a carteira de direitos creditórios é FEITA. É o corte que separa fundos incomparáveis com o mesmo patrimônio: consignado, precatório e factoring corporativo têm perfis de perda que não se parecem, e sem ele o universo de FIDC é uma lista de patrimônios sem natureza. **Duas camadas convivem na resposta e NÃO se somam.** `is_subcategory: false` são as 11 categorias de topo e já cobrem a carteira inteira; as demais reabrem algumas delas em detalhe (consignado dentro de Financeiro, precatório dentro de Setor público), com `parent_code` apontando a mãe. Somar as duas juntas dobra a carteira — quem quer o mix filtra o topo. Setor sem exposição não vira linha: a fonte é formulário de preenchimento completo e a esmagadora maioria das células vem zerada. Ausência de linha significa sem exposição, nunca dado faltando. `unclassified_total` no `meta` é a parte da carteira que a classe não abriu por setor. Sem ele, um mix parcial passaria por completo, e a classe que não declara nada devolveria lista vazia — indistinguível de fundo sem carteira. `pct_of_portfolio` é fração da CARTEIRA, não do patrimônio: um FIDC alavancado tem carteira maior que o PL e usar PL faria a mesma exposição parecer menor.