# Penalty Metrics

## Contents

* [Penalty Amounts](#penaltyntv)

## Penalty Amounts <a href="#penaltyntv" id="penaltyntv"></a>

### Definition

Amount of tokens taken as penalty from Validators in native units.

| Name            | MetricID   | Unit         | Interval      |
| --------------- | ---------- | ------------ | ------------- |
| Penalty Amounts | PenaltyNtv | Native Units | 1 day, 1 hour |

### Asset Specific Details

* This metric is available for Ethereum only under the ETH\_CL ticker. The definition of penalties follows that of Ethereum as outlined here: <https://ethereum.org/en/developers/docs/consensus-mechanisms/pos/rewards-and-penalties/#penalties>

### Release History

* Released November 2023.

### Availability for Assets

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/PenaltyNTV>" %}

## API Endpoints

Flows metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `PenaltyNtv` in the `metrics` parameter.

{% openapi src="<https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-1522f16027d90845f8750dd9c51c03b8e7aab67f%2Fopenapi.yaml?alt=media>" path="/timeseries/asset-metrics" method="get" %}
[openapi.yaml](https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-1522f16027d90845f8750dd9c51c03b8e7aab67f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% tabs %}
{% tab title="Shell" %}

```shell
curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PenaltyNtv&assets=eth&pretty=true&api_key=<your_key>"
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PenaltyNtv&assets=eth&pretty=true&api_key=<your_key>').json()
print(response)
```

{% endtab %}

{% tab title="Python Client" %}

```python
from coinmetrics.api_client import CoinMetricsClient

api_key = "<API_KEY>"
client = CoinMetricsClient(api_key)

print(
    client.get_asset_metrics(
        metrics="PenaltyNtv", 
        assets="eth",
    ).to_dataframe()
)
```

{% endtab %}
{% endtabs %}
