Rating de crédito vigente, com a fonte primária de cada nota
Notas de agência observadas em documentos protocolados na CVM e no FNET, uma linha por (agência, papel) com a mais recente vigente. Toda resposta traz `agency`, `action_date` e `download_url`: a citação é parte do dado. Não emitimos rating — quando agências divergem, todas aparecem, e nenhuma nota é consolidada num rating nosso. `rating_notch` (1 = melhor) só é comparável **dentro da mesma `scale`**: um emissor brasileiro costuma ser AAA na escala nacional e BB na global ao mesmo tempo, e ordenar as duas juntas produz ranking que parece certo e está errado. Filtre por `scale` antes de comparar. `action_date_known=false` significa que a vigência foi decidida pela data de protocolo do documento (`doc_filed_at`), porque o relatório não afirma a data da ação — use-a para ordenar, nunca para exibir como data da agência. `declared` traz, quando existe, o rating que a própria securitizadora declarou no informe mensal da CVM para o mesmo ISIN. É segunda fonte para conferência: campo livre e mal preenchido, com `is_parseable=false` significando **não declarado no informe** — nunca 'o papel não tem rating'. Cobertura é parcial e cresce com a indexação: ausência de um papel aqui significa que ainda não observamos documento de rating dele, não que ele seja sem nota.
In: header
Query Parameters
1001 <= value <= 1000ISIN do papel avaliado (CRI/CRA).
4 <= lengthCNPJ do emissor avaliado (14 dígitos, sem pontuação).
^\d{14}$Agência classificadora.
"fitch" | "moodys" | "sp" | "austin" | "sr" | "liberum" | "other"A que a nota se refere.
"issuer" | "securitization" | "fidc" | "stock"Escala. Fixe-a antes de comparar rating_notch entre papéis.
"national_br" | "global"Confiança declarada da extração.
"high" | "medium" | "low"Response Body
curl -X GET "https://api.databolsa.com/v1/credit/ratings?cursor=string&limit=100&assetCode=string&issuerCnpj=string&agency=fitch&entityType=issuer&scale=national_br&confidence=high"{
"data": [
{
"entity_type": "string",
"issuer_cnpj": "string",
"asset_code": "string",
"agency": "string",
"agency_raw": "string",
"scale": "national_br",
"rating_raw": "string",
"rating": "string",
"rating_notch": 0,
"outlook": "string",
"watch": "string",
"action": "string",
"action_date": "string",
"doc_filed_at": "string",
"action_date_known": true,
"source": "string",
"protocol": "string",
"download_url": "string",
"page_start": 0,
"evidence_quote": "string",
"extraction_confidence": "string",
"extracted_at": "string",
"declared": {
"rating_raw": "string",
"agency_raw": "string",
"reference_date": "string",
"is_parseable": true
}
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
}
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}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.
Demanda institucional pela debênture, mês a mês
Série mensal da demanda de fundos pelo papel: nº de fundos detentores, quantidade e valor somados, e o fluxo declarado do mês (`net_traded_brl` = compras − vendas informadas pelos próprios fundos). CAVEAT essencial: o painel de fundos que divulga carteira muda de tamanho todo mês (`funds_panel_n` — meses de fim de trimestre têm quase o dobro de divulgantes), então queda de `funds_value_brl` entre meses geralmente mede queda de DIVULGAÇÃO, não venda. Para fluxo real use `net_traded_brl`, nunca a diferença de posição entre meses. Mais recente primeiro.