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

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.

GET
/v1/credit/ratings
AuthorizationBearer <token>

In: header

Query Parameters

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

ISIN do papel avaliado (CRI/CRA).

Length4 <= length
issuerCnpj?string

CNPJ do emissor avaliado (14 dígitos, sem pontuação).

Match^\d{14}$
agency?string

Agência classificadora.

Value in"fitch" | "moodys" | "sp" | "austin" | "sr" | "liberum" | "other"
entityType?string

A que a nota se refere.

Value in"issuer" | "securitization" | "fidc" | "stock"
scale?string

Escala. Fixe-a antes de comparar rating_notch entre papéis.

Value in"national_br" | "global"
confidence?string

Confiança declarada da extração.

Value in"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"
}