Comment les paramètres « metric » et « rating_scale » déterminent les valeurs de risque de crédit et les noms de champs renvoyés par l’API Analytics.
Deux paramètres 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 notations utiliser pour les valeurs de PD.
Ces données 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. Pour la sélection d’itinéraire, consultez Choix d’une méthode.
metric Sélectionne le résultat consensuel 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 une comparaison « hors-moi » lorsque cette fonctionnalité est prise en charge.
Utilisateurs contributeurs
CCR Il s’agit de la valeur par défaut.MyRating Nécessite un droit d’accès 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 période demandée scopeet 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.
rating_scale Il 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 métriques lorsque vos droits vous y autorisent.
metric modifie les noms des champs renvoyés par chaque route. getdata Il ne s’agit pas d’une route de métriques et elle renvoie toujours des champs de consensus.
getdata
aggregatetrend
creditbreakdown
entityratingchange
ratingdistribution
getdata n’accepte pas metric. Elle renvoie toujours les 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.
aggregatetrend renvoie une ligne agrégée par date dans la fenêtre rétrospective. La modification de metric permet d’inverser les noms des champs d’agrégation et, pour MyRating, ajoute une comparaison « client » par rapport à « hors-moi ».Le CCR renvoie des champs agrégés consensuels. AGG_EntityCount Ce champ correspond au nombre d’entités concernées disposant de données consensuelles à chaque date.
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 total peut être inférieur au nombre d’entités comprises dans votre périmètre si votre banque ne les évalue pas toutes.
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 Elle permet de choisir entre les agrégats consensuels et la vision de votre banque par rapport à « hors-maison ».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.
MyRating ajoute des agrégats « client » et « hors contribution » 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.
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 contributeur 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.
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.
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’entrée : CCR utilise une seule série, tandis que MyRating divise le résultat en deux séries.Le CCR renvoie un seul ccr objet. Les clés des tranches de notation telles que bbb+ et a- contiennent la part d’entités dans chaque tranche.
MyRating renvoie des objets distincts 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 catégorie.
