> ## 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.
# Métricas y escalas de calificación
> Cómo controlan los parámetros «metric» y «rating_scale» qué valores de riesgo de crédito y qué nombres de campos de respuesta devuelve la API de Credit Benchmark Analytics.
Dos campos de solicitud controlan la vista de crédito devuelta por las rutas analíticas:
* **`metric`** — cuya visión crediticia se desea medir.
* **`rating_scale`** — qué etiquetas de calificación utilizar para los valores de PD.
Ambos valores son independientes; modificar uno no implica automáticamente la modificación del otro.
Para más información sobre el comportamiento del ámbito, consulte [Ámbito de aplicación y resultados vacíos](/api-reference/analytics-scope-and-empty-results). Para la selección de rutas, consulte [Elección de una ruta](/api-reference/analytics-endpoints).
## Métrica
`metric` selecciona el resultado de consenso o el específico de cada colaborador.
| Valor | Significado | Usuario típico |
| ---------- | ------------------------------------------------------------------------------------------------- | --------------------------------------- |
| `CCR` | Visión de consenso de Credit Benchmark | Cualquier usuario autorizado de la API. |
| `MyRating` | Solicitar la vista de calificación del colaborador, con comparación «ex-me» cuando sea compatible | Usuarios colaboradores |
`CCR` Esta es la configuración predeterminada.
`MyRating` Requiere autorización de colaborador. Utiliza únicamente las calificaciones enviadas por el colaborador solicitante y el índice de referencia «ex-me». No revela las calificaciones individuales de otros colaboradores.
Cuando seleccione `metric: "MyRating"`, el análisis se limita a las entidades de su `scope` **que su banco haya calificado** para el intervalo de fechas solicitado. Si su banco no ha calificado ninguna entidad en el ámbito solicitado, la ruta devuelve una respuesta de éxito vacía.
## Escala de calificación
`rating_scale` selecciona el conjunto de etiquetas utilizado para describir los valores de PD.
| Valor | Descripción |
| --------- | ----------------------------------------------------------------------------------------- |
| `CB21` | Escala de 21 niveles de Credit Benchmark (`aaa`, `aa+`, `aa`, `aa-`, y así sucesivamente) |
| `CB7` | Escala de Credit Benchmark más gruesa, con menos categorías |
| `MyScale` | Solicitar la escala maestra configurada por el colaborador |
Los campos de PD permanecen como valores numéricos. `rating_scale` Solo cambia la etiqueta de calificación o la clave de grupo utilizada junto con ellos.
`MyScale` es habitual con `MyRating`, pero la selección de la escala es independiente de la selección de métricas, siempre que sus derechos de acceso lo permitan.
## Respuesta por punto final y métrica
`metric` Cambia los nombres de los campos devueltos por cada ruta. `getdata` No se trata de una ruta de métricas y siempre devuelve campos de consenso.
`getdata` No acepta `metric`. Siempre devuelve campos de consenso a nivel de fila para cada entidad y fecha dentro del ámbito solicitado. Nombres de campos como `CB_CCR` y `CB_CCR_PD` describen la visión de consenso 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` devuelve una fila agregada por cada fecha de la ventana retrospectiva. Al cambiar `metric` cambia los nombres de los campos de agregación y, en el caso de `MyRating`, añade una comparación entre el cliente y el «ex-me».
**El CCR** devuelve campos agregados de consenso. `AGG_EntityCount` Es el número de entidades incluidas en el ámbito con datos de consenso en cada fecha.
```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** devuelve la calificación agregada y la PD de su banco junto con el valor de referencia «ex-me» para el mismo subconjunto cubierto por el colaborador. `AGG_ClientEntityCount` El recuento de entidades puede ser inferior al número de entidades incluidas en su ámbito de aplicación si su banco no califica a todas ellas.
```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` Devuelve el último resumen crediticio agregado para cada valor de `facet_column`, como el sector o el país. `metric` controla si se muestran los agregados de consenso o la visión de su banco en comparación con «ex-me».
**El CCR** devuelve una calificación y una PD agregadas por cada grupo de facetas, además del recuento de entidades con datos de consenso en dicho grupo.
```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** añade agregados de «cliente» y «ex-me» para las entidades cubiertas por el colaborador en cada grupo. También puede devolver campos de comparación de notches, tales como `AGG_NotchDifference` y `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` Devuelve una fila por entidad con los valores actuales y de referencia de calificación y PD. Los campos de variación del consenso están siempre presentes. `MyRating` Incluye los campos de cambio de calificación de su banco cuando existan datos de los colaboradores.
**El CCR** devuelve los valores consensuados de calificación y PD en la fecha de vigencia y en la fecha de referencia, además de campos de variación tales como `CB_CCR_Change` y `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** conserva los campos de cambio de consenso y añade campos de cliente como `ClientRating`, `ClientRating_6M`, y `ClientRating_Change` para las entidades que califica su banco.
```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` devuelve la proporción de entidades incluidas en el ámbito de aplicación en cada categoría de calificación. La estructura de la respuesta varía más con `metric` que en la mayoría de las rutas: `CCR` utiliza una serie, mientras que `MyRating` divide el resultado en dos.
**El CCR** devuelve un único `ccr` objeto. Las claves de los grupos de calificación, tales como `bbb+` y `a-` contienen la proporción de entidades en cada grupo.
```json theme={null}
{
"ccr": {
"CB_Effective_Date_ID": [20250131],
"bbb+": [0.60],
"a-": [0.40],
"AGG_EntityCount": [5]
}
}
```
**MyRating** devuelve `my_bank` y `ex_me` para el subconjunto cubierto por el colaborador. Cada serie utiliza las etiquetas de calificación de su escala como claves de los grupos.
```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]
}
}
```
## Etiquetas de calificación por escala
Un mismo PD puede asignarse a diferentes etiquetas en función de la escala solicitada.
```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]
}
```
La etiqueta exacta `MyScale` La etiqueta exacta depende de la escala configurada por su banco.
## Lo que no hace la escala de calificación
* Modificar qué entidades se incluyen `scope`
* Conceder acceso exclusivo a los colaboradores
* Expone las calificaciones de otro banco
* Modificar los valores numéricos de PD
* Realizar `CCR` y `MyRating` números de entidades directamente comparables