> ## 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.
# Indicateurs et échelles de notation
> Comment les paramètres « metric » et « rating_scale » déterminent les valeurs de risque de crédit et les noms des champs de réponse renvoyés par l’API Credit Benchmark Analytics.
Deux champs de requête contrôlent la vue de crédit renvoyée par les routes analytiques :
* **`metric`** — dont la situation de crédit doit être évaluée.
* **`rating_scale`** — quelles étiquettes de notation utiliser pour les valeurs de PD.
Ces deux valeurs sont indépendantes : la modification de l’une ne entraîne pas automatiquement celle de l’autre.
Pour le comportement de la portée, consultez [Portée et résultats vides](/api-reference/analytics-scope-and-empty-results). Pour la sélection d’itinéraire, consultez [Choix d’une approche](/api-reference/analytics-endpoints).
## Indicateur
`metric` Sélectionne une sortie de consensus ou spécifique à un contributeur.
| Valeur | Signification | Utilisateur type |
| ---------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `CCR` | Vue consensuelle de Credit Benchmark | Tout utilisateur de l’API disposant des droits nécessaires |
| `MyRating` | Demande la vue de notation du contributeur, avec comparaison « ex-me » lorsque cela est pris en charge | Utilisateurs contributeurs |
`CCR` La valeur par défaut est utilisée.
`MyRating` Nécessite des droits de contributeur. Cette fonction utilise uniquement les notations soumises par le contributeur demandeur et la référence « ex-me ». Elle ne divulgue pas les notations individuelles d’un autre contributeur.
Lorsque vous sélectionnez `metric: "MyRating"`, l’analyse se limite aux entités de la `scope` **et que votre banque a notées** pour la période demandée. Si votre banque n’a noté aucune entité dans le périmètre demandé, l’appel renvoie une réponse de réussite vide.
## Échelle de notation
`rating_scale` sélectionne l’ensemble de libellés utilisé pour décrire les valeurs de PD.
| Valeur | Description |
| --------- | ------------------------------------------------------------------------ |
| `CB21` | Échelle à 21 notches de Credit Benchmark (`aaa`, `aa+`, `aa`, `aa-`etc.) |
| `CB7` | Échelle de référence de crédit plus grossière avec moins de tranches |
| `MyScale` | Demande de l’échelle de référence configurée par le contributeur |
Les champs PD demeurent numériques. `rating_scale` Seul le libellé de notation ou la clé de tranche associée est modifié.
`MyScale` est courant avec `MyRating`, mais la sélection de l’échelle est distincte de celle des indicateurs lorsque vos droits vous y autorisent.
## Réponse par point de terminaison et métrique
`metric` ne modifie pas les noms des champs renvoyés par chaque route. `getdata` Ce n’est pas une route de métrique et renvoie toujours des champs de consensus.
`getdata` Ne prend pas en charge `metric`. Elle renvoie toujours des champs de consensus au niveau des lignes pour chaque entité et chaque date de votre périmètre. Les noms de champs tels que `CB_CCR` et `CB_CCR_PD` décrivent la vue de consensus de 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` renvoie une ligne agrégée par date dans la fenêtre rétrospective. La modification `metric` permet d’inverser les libellés des champs agrégés et, pour `MyRating`, ajoute une comparaison « client » par rapport à « hors-client ».
**Le CCR** renvoie des champs agrégés consensuels. `AGG_EntityCount` Il s’agit du nombre d’entités concernées disposant de données consensuelles à chaque date.
```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** renvoie la notation agrégée et la PD de votre banque, ainsi que la référence « ex-me » pour le même sous-ensemble couvert par le contributeur. `AGG_ClientEntityCount` Ce nombre peut être inférieur au nombre d’entités comprises dans votre périmètre si votre banque ne les note pas toutes.
```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` renvoie le dernier résumé de crédit agrégé pour chaque valeur de `facet_column`, tels que le secteur ou le pays. `metric` détermine si vous visualisez les agrégats consensuels ou la vue de votre banque par rapport à « ex-me ».
**Le CCR** renvoie une notation agrégée et une PD par groupe de facettes, ainsi que le nombre d’entités pour lesquelles des données consensuelles sont disponibles dans ce groupe.
```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** ajoute des agrégats « client » et « ex-me » pour les entités couvertes par le contributeur au sein de chaque groupe. Il peut également renvoyer des champs de comparaison par échelons, tels que `AGG_NotchDifference` et `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` renvoie une ligne par entité avec les valeurs actuelles et historiques de notation et de PD. Les champs relatifs à l’évolution du consensus sont toujours présents. `MyRating` ajoute les champs de variation de notation de votre banque lorsque des données de contributeurs sont disponibles.
**Le CCR** renvoie les valeurs consensuelles de notation et de PD à la date d’effet et à la date de référence, ainsi que des champs de variation tels que `CB_CCR_Change` et `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** conserve les champs de modification du consensus et ajoute des champs client tels que `ClientRating`, `ClientRating_6M`, etc. `ClientRating_Change` pour les entités notées par votre banque.
```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` renvoie la part des entités concernées dans chaque tranche de notation. La structure de la réponse varie davantage avec `metric` que la plupart des points d’accès : `CCR` utilise une seule série, tandis que `MyRating` divise le résultat en deux.
**Le CCR** renvoie un seul `ccr` objet. Les clés de tranche de notation telles que `bbb+` et `a-` contiennent la part d’entités dans chaque tranche.
```json theme={null}
{
"ccr": {
"CB_Effective_Date_ID": [20250131],
"bbb+": [0.60],
"a-": [0.40],
"AGG_EntityCount": [5]
}
}
```
**MyRating** renvoie des `my_bank` et `ex_me` pour le sous-ensemble couvert par le contributeur. Chaque série utilise les étiquettes de notation de votre échelle comme clés de tranche.
```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]
}
}
```
## Étiquettes de notation par échelle
Une même PD peut correspondre à des étiquettes différentes selon l’échelle demandée.
```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’étiquette exacte `MyScale` dépend de l’échelle configurée par votre banque.
## Ce que l’échelle de notation ne permet pas de faire
* Modifier la liste des entités incluses `scope`
* Accorder un accès réservé aux contributeurs
* Divulguer les notations d’une autre banque
* Modifier les valeurs numériques de PD
* Rendre `CCR` et `MyRating` nombre d’entités directement comparables