> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Metriche e scale di rating
> In che modo i parametri «metric» e «rating_scale» determinano quali valori di rischio di credito e quali nomi dei campi di risposta vengono restituiti dall’API di Credit Benchmark Analytics.
Due campi di richiesta controllano la vista di credito restituita dai percorsi analitici:
* **`metric`** — di chi misurare la visione del credito.
* **`rating_scale`** — quali etichette di rating utilizzare per i valori di PD.
Sono indipendenti. La modifica di uno non comporta automaticamente la modifica dell’altro.
Per il comportamento dell’ambito, consultare [Ambito e risultati vuoti](/api-reference/analytics-scope-and-empty-results). Per la selezione del percorso, consultare [Scelta di un percorso](/api-reference/analytics-endpoints).
## Metriche
`metric` seleziona l’output di consenso o specifico per i contributori.
| Valore | Significato | Utente tipico |
| ---------- | -------------------------------------------------------------------------------------- | -------------------------------- |
| `CCR` | Visione di consenso di Credit Benchmark | Qualsiasi utente API autorizzato |
| `MyRating` | Richiesta della vista di rating del contributore, con confronto «ex-me» ove supportato | Utenti contributori |
`CCR` è l’impostazione predefinita.
`MyRating` Richiede l’autorizzazione del contributore. Utilizza esclusivamente i rating inviati dal contributore richiedente e il benchmark «ex-me». Non espone i rating individuali di altri contributori.
Quando si seleziona `metric: "MyRating"`, l’analisi è limitata alle entità `scope` **e che la Sua banca ha valutato** per l’intervallo di date richiesto. Se la Sua banca non ha valutato alcuna entità nell’ambito richiesto, il percorso restituisce una risposta di successo vuota.
## Scala di rating
`rating_scale` seleziona l’insieme di etichette utilizzato per descrivere i valori di PD.
| Valore | Descrizione |
| --------- | ------------------------------------------------------------------------------------ |
| `CB21` | Scala a 21 notches di Credit Benchmark (`aaa`, `aa+`, `aa`, `aa-`e così via) |
| `CB7` | Scala di riferimento del credito più approssimativa con un numero inferiore di fasce |
| `MyScale` | Richiesta della scala principale configurata dal contributore |
I campi PD rimangono numerici. `rating_scale` Viene modificata soltanto l’etichetta di rating o la chiave di intervallo associata a tali valori.
`MyScale` è una pratica comune con `MyRating`Tuttavia, la scelta della scala è distinta dalla selezione delle metriche, nei limiti delle Sue autorizzazioni.
## Risposta per endpoint e metrica
`metric` modifica i nomi dei campi restituiti da ciascuna route. `getdata` Non si tratta di un percorso metrico e restituisce sempre i campi di consenso.
`getdata` Non accetta `metric`. Restituisce sempre campi di consenso a livello di riga per ciascuna entità e data nell’ambito specificato. Nomi di campi quali `CB_CCR` e `CB_CCR_PD` descrivono la visione di consenso di Credit Benchmark.
```json theme={null}
{
"CB_ID": ["CB0000022706"],
"CB_Legal_Name": ["Example Bank PLC"],
"CB_Effective_Date_ID": [20250131],
"CB_CCR": ["bbb+"],
"CB_CCR_100_PDMid": [0.0040]
}
```
`aggregatetrend` restituisce una riga aggregata per ogni data nella finestra di lookback. Modificando `metric` cambia i nomi dei campi di aggregazione e, per `MyRating`, aggiunge un confronto tra cliente ed ex-me.
**Il CCR** restituisce campi aggregati di consenso. `AGG_EntityCount` è il numero di entità incluse nell’ambito con dati di consenso a ciascuna data.
```json theme={null}
{
"CB_Effective_Date_ID": [20240131, 20240229],
"AGG_CCRPD_log": [-5.4968, -5.5215],
"AGG_CCR": ["bbb+", "bbb+"],
"AGG_CCRPD": [0.0041, 0.0040],
"AGG_CCRPD_index": [102.5, 100.0],
"AGG_EntityCount": [3, 3]
}
```
**MyRating** restituisce il rating aggregato e il PD della Sua banca insieme al benchmark «ex-me» per lo stesso sottoinsieme coperto dal contributore. `AGG_ClientEntityCount` Tale valore può risultare inferiore al numero di entità presenti nel Suo ambito di analisi qualora la Sua banca non disponga di valutazioni per tutte le entità.
```json theme={null}
{
"CB_Effective_Date_ID": [20240131, 20240229],
"AGG_ClientRating": ["4.2", "4.2"],
"AGG_ClientRatingNotch": [12, 12],
"AGG_ClientPD_log": [-5.5994, -5.5730],
"AGG_ClientPD": [0.0037, 0.0038],
"AGG_ClientPD_index": [97.4, 100.0],
"AGG_ClientEntityCount": [2, 2],
"AGG_ExMeRating": ["4.3", "4.3"],
"AGG_ExMeRatingNotch": [13, 13],
"AGG_ExMePD_log": [-5.4262, -5.4037],
"AGG_ExMePD": [0.0044, 0.0045],
"AGG_ExMePD_index": [97.8, 100.0],
"AGG_ExMeEntityCount": [2, 2]
}
```
`creditbreakdown` restituisce l’ultimo riepilogo creditizio aggregato per ciascun valore di `facet_column`, ad esempio settore o Paese. `metric` determina se vengono visualizzati gli aggregati di consenso o la visione della propria banca rispetto a «ex-me».
**Il CCR** restituisce un rating aggregato e un PD per ciascun gruppo di faccette, oltre al numero di entità per le quali sono disponibili dati di consenso in quel gruppo.
```json theme={null}
{
"CB_Sector": ["Banks", "Industrials"],
"AGG_CCR": ["bbb+", "a-"],
"AGG_CCRPD": [0.0040, 0.0018],
"AGG_EntityCount": [12, 8],
"AGG_Upgrades": [2, 1],
"AGG_Downgrades": [1, 0],
"AGG_NetUpMinusDown": [1, 1]
}
```
**MyRating** aggiunge aggregati «client» ed «ex-me» per le entità coperte dal contributore in ciascun gruppo. Può inoltre restituire campi di confronto tra livelli di rating, quali `AGG_NotchDifference` e `AGG_NotchDiffAggressive`.
```json theme={null}
{
"CB_Sector": ["Banks"],
"AGG_ClientRating": ["4.2"],
"AGG_ClientPD": [0.0037],
"AGG_ClientEntityCount": [5],
"AGG_ExMeRating": ["4.3"],
"AGG_ExMePD": [0.0044],
"AGG_ExMeEntityCount": [5],
"AGG_NotchDifference": [1],
"AGG_NotchDiffAggressive": [1],
"AGG_NotchDiffConsistent": [4],
"AGG_NotchDiffConservative": [0]
}
```
`entityratingchange` Restituisce una riga per ogni entità con i valori correnti e di arretramento del rating e del PD. I campi relativi alle variazioni di consenso sono sempre presenti. `MyRating` Aggiunge i campi relativi alle variazioni di rating della propria banca laddove siano disponibili i dati dei contributori.
**Il CCR** restituisce i valori di rating e di PD di consenso alla data di efficacia e alla data di riferimento, oltre a campi variabili quali `CB_CCR_Change` e `CB_CCR_PD_Change`.
```json theme={null}
{
"CB_ID": ["CB0000022706"],
"CB_Legal_Name": ["Example Bank PLC"],
"CB_CCR": ["bbb+"],
"CB_CCR_6M": ["bbb"],
"CB_CCR_PD": [0.0040],
"CB_CCR_PD_6M": [0.0048],
"CB_CCR_Change": [-1],
"CB_CCR_PD_Change": [-0.0008],
"CB_CCR_Change_With_OCI": [-1]
}
```
**MyRating** mantiene i campi relativi alle variazioni di consenso e aggiunge campi specifici del cliente quali `ClientRating`, `ClientRating_6M`, e `ClientRating_Change` per le entità valutate dalla vostra banca.
```json theme={null}
{
"CB_ID": ["CB0000022706"],
"CB_Legal_Name": ["Example Bank PLC"],
"CB_CCR": ["bbb+"],
"CB_CCR_6M": ["bbb"],
"CB_CCR_PD": [0.0040],
"CB_CCR_PD_6M": [0.0048],
"CB_CCR_Change": [-1],
"CB_CCR_PD_Change": [-0.0008],
"CB_CCR_Change_With_OCI": [-1],
"ClientRating": ["4.2"],
"ClientRating_6M": ["4.3"],
"ClientPD": [0.0037],
"ClientPD_6M": [0.0041],
"ClientRating_Change": [-1],
"ClientRating_Change_With_OCI": [-1]
}
```
`ratingdistribution` restituisce la quota di entità incluse nell’ambito di applicazione in ciascuna fascia di rating. La struttura della risposta varia maggiormente con `metric` rispetto alla maggior parte dei percorsi: `CCR` utilizza una sola serie, mentre `MyRating` suddivide il risultato in due serie.
**Il CCR** restituisce un unico `ccr` oggetto. Le chiavi delle fasce di rating, quali `bbb+` e `a-` contengono la quota di entità presente in ciascun intervallo.
```json theme={null}
{
"ccr": {
"CB_Effective_Date_ID": [20250131],
"bbb+": [0.60],
"a-": [0.40],
"AGG_EntityCount": [5]
}
}
```
**MyRating** restituisce oggetti separati `my_bank` e `ex_me` per il sottoinsieme coperto dal contributore. Ogni serie utilizza le etichette di rating della vostra scala come chiavi dei segmenti.
```json theme={null}
{
"my_bank": {
"CB_Effective_Date_ID": [20250131],
"4.2": [0.60],
"4.3": [0.40],
"AGG_EntityCount": [5]
},
"ex_me": {
"CB_Effective_Date_ID": [20250131],
"4.2": [0.20],
"4.3": [0.80],
"AGG_EntityCount": [5]
}
}
```
## Etichette di rating per scala
Lo stesso PD può corrispondere a etichette diverse a seconda della scala richiesta.
```json theme={null}
{
"metric": "CCR",
"rating_scale": "CB21"
}
```
```json theme={null}
{
"AGG_CCR": ["bbb+"],
"AGG_CCRPD": [0.0040],
"AGG_CCRPD_log": [-5.5215],
"AGG_CCRPD_index": [100.0]
}
```
```json theme={null}
{
"metric": "CCR",
"rating_scale": "MyScale"
}
```
```json theme={null}
{
"AGG_CCR": ["4.2"],
"AGG_CCRPD": [0.0040],
"AGG_CCRPD_log": [-5.5215],
"AGG_CCRPD_index": [100.0]
}
```
L’etichetta esatta `MyScale` dipendono dalla scala configurata dalla vostra banca.
## Cosa non fa la scala di rating
* Modificare quali entità sono incluse `scope`
* Concedere l’accesso esclusivamente ai collaboratori
* Esporre i rating di un’altra banca
* Modificare i valori numerici del PD
* Rendere `CCR` e `MyRating` numero di entità direttamente comparabili