> ## 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.

# Metrikker og vurderingsskalaer

> Hvordan parametrene «metric» og «rating_scale» styrer hvilke kredittrisikoverdier og navn på svarfelter som Credit Benchmark Analytics API returnerer.

To forespørselsfelt styrer kredittvisningen som returneres av analytiske ruter:

* **`metric`** — kredittprofil som skal måles.
* **`rating_scale`** — hvilke ratingetiketter som skal anvendes for PD-verdier.

De er uavhengige av hverandre. Endring av den ene fører ikke automatisk til endring av den andre.

For informasjon om omfangsadferd, se [Omfang og tomme resultater](/api-reference/analytics-scope-and-empty-results). For informasjon om rutevalg, se [Velge en rute](/api-reference/analytics-endpoints).

## Metrisk

`metric` velger konsensus eller bidragsyter-spesifikk utdata.

| Verdi      | Betydning                                                                           | Typisk bruker                |
| ---------- | ----------------------------------------------------------------------------------- | ---------------------------- |
| `CCR`      | Konsensusoversikt fra Credit Benchmark                                              | Enhver berettiget API-bruker |
| `MyRating` | Be om bidragsyterens vurderingsvisning, med «ex-me»-sammenligning der dette støttes | Bidragsyterbrukere           |

`CCR` Dette er standardinnstillingen.

`MyRating` Krever bidragsyterrettigheter. Den bruker kun de innsendte vurderingene fra den forespørrende bidragsyteren og «ex-me»-benchmarken. Den viser ikke andre bidragsyteres individuelle vurderinger.

<Warning>
  Når du velger `metric: "MyRating"`, er analysen begrenset til enheter i det forespurte `scope` **som banken din har vurdert** for det forespurte datoområdet. Hvis banken din ikke har vurdert noen enheter innenfor det forespurte omfanget, returnerer ruten et tomt suksesssvar.
</Warning>

## Vurderingsskala

`rating_scale` velger etikettsettet som beskriver PD-verdiene.

| Verdi     | Beskrivelse                                                              |
| --------- | ------------------------------------------------------------------------ |
| `CB21`    | Credit Benchmark 21-trinns skala (`aaa`, `aa+`, `aa`, `aa-`og så videre) |
| `CB7`     | Grovere Credit Benchmark-skala med færre kategorier                      |
| `MyScale` | Be om bidragsyterens konfigurerte hovedskala                             |

PD-feltene forblir numeriske. `rating_scale` Endrer kun ratingetiketten eller kategorienøkkelen som benyttes sammen med disse verdiene.

`MyScale` er vanlig med `MyRating`, men valg av skala er adskilt fra valg av måleparameter der dine rettigheter tillater dette.

## Svar etter endepunkt og måleparameter

`metric` endrer feltnavnene som returneres av hver rute. `getdata` Dette er ikke en metrikkrute og returnerer alltid konsensusfelt.

<Tabs>
  <Tab title="getdata">
    `getdata` tilbys ikke `metric`. Den returnerer alltid konsensusfelt på radnivå for hver enhet og dato i omfanget ditt. Feltnavn som `CB_CCR` og `CB_CCR_PD` beskriver Credit Benchmark-konsensusvisningen.

    ```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]
    }
    ```
  </Tab>

  <Tab title="aggregatetrend">
    `aggregatetrend` Returnerer én aggregeringsrad per dato i tilbakeskuingsvinduet. Endring `metric` endrer navnene på aggregeringsfeltene, og for `MyRating`tillegger en sammenligning mellom klient og eks-meg.

    **CCR** returnerer konsensusaggregatfelt. `AGG_EntityCount` Antall enheter innenfor omfanget som har konsensusdata på hver dato.

    ```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** returnerer bankens samlede rating og PD sammen med «ex-me»-benchmarken for den samme delmengden som dekkes av bidragsyteren. `AGG_ClientEntityCount` Dette tallet kan være lavere enn antall enheter i omfanget dersom banken ikke har vurdert alle.

    ```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]
    }
    ```
  </Tab>

  <Tab title="creditbreakdown">
    `creditbreakdown` returnerer den nyeste samlede kredittoversikten for hver verdi av `facet_column`for eksempel sektor eller land. `metric` styrer om du ser konsensusaggregater eller bankens egen visning sammenlignet med «ex-me».

    **CCR** returnerer én samlet rating og PD per fasettgruppe, pluss antall enheter med konsensusdata i den gruppen.

    ```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** legger til klient- og ex-me-aggregater for enhetene som dekkes av bidragsyteren i hver gruppe. Den kan også returnere felt for sammenligning av ratingnivåer, for eksempel `AGG_NotchDifference` og `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]
    }
    ```
  </Tab>

  <Tab title="entityratingchange">
    `entityratingchange` Returnerer én rad per enhet med gjeldende og historiske rating- og PD-verdier. Feltene for konsensusendring er alltid til stede. `MyRating` legger til bankens felt for ratingendringer der det finnes bidragsyterdata.

    **CCR** returnerer konsensusvurdering og PD-verdier på ikrafttredelsesdatoen og på tilbakeskuingsdatoen, samt endringsfelt som `CB_CCR_Change` og `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** beholder konsensusendringsfeltene og legger til kundefelt som `ClientRating`, `ClientRating_6M`, og `ClientRating_Change` for enheter som banken din vurderer.

    ```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]
    }
    ```
  </Tab>

  <Tab title="ratingdistribution">
    `ratingdistribution` returnerer andelen av enheter innenfor omfanget i hver vurderingsgruppe. Svarstrukturen endres mer med `metric` enn de fleste ruter: `CCR` bruker én serie, mens `MyRating` deler resultatet i to.

    **CCR** returnerer et enkelt `ccr` objekt. Ratingkategorinøkler som `bbb+` og `a-` inneholder andelen av enheter i hver gruppe.

    ```json theme={null}
    {
      "ccr": {
        "CB_Effective_Date_ID": [20250131],
        "bbb+": [0.60],
        "a-": [0.40],
        "AGG_EntityCount": [5]
      }
    }
    ```

    **MyRating** returnerer separate `my_bank` og `ex_me` objekter for den delmengden som dekkes av bidragsyteren. Hver serie bruker ratingetikettene i skalaen din som kategorienøkler.

    ```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]
      }
    }
    ```
  </Tab>
</Tabs>

## Vurderingsetiketter etter skala

Den samme PD-en kan tilordnes ulike etiketter avhengig av hvilken skala du ber om.

<AccordionGroup>
  <Accordion title="Den samme PD-en er merket på CB21-skalaen.">
    ```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]
    }
    ```
  </Accordion>

  <Accordion title="Den samme PD-en merkes i henhold til din konfigurerte MyScale.">
    ```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]
    }
    ```

    Den eksakte `MyScale` Den nøyaktige ratingkoden avhenger av den konfigurerte skalaen til banken din.
  </Accordion>
</AccordionGroup>

## Hva en vurderingsskala ikke gjør

* Endre hvilke enheter som inngår i `scope`
* Gi tilgang kun til bidragsytere
* Vise en annen banks vurderinger
* Endre numeriske PD-verdier
* Gjøre `CCR` og `MyRating` Antall enheter direkte sammenlignbare
