# Transactions

## Contents

* [Tx Cnt](#txcnt)
* [Tx per Second Cnt](#txcntsec)
* [Tx Mean Size](#txmeanbyte)
* [OP\_RETURN Tx Cnt](#txopretcnt)
* [Shielded Tx Cnt](#txshldcnt)
* [Fully Shielded Tx Cnt](#txshldfullcnt)
* [Transactions, count, vote](#transactions-count-vote)
* [Transactions, count, nonvote](#transactions-count-nonvote)
* [MEV Transactions, count](#mev-transaction-count)

## Tx Cnt <a href="#txcnt" id="txcnt"></a>

### Definition

The sum count of transactions that day. Transactions represent a bundle of intended actions to alter the ledger initiated by a user (human or machine). On certain occasions, transactions are counted regardless of whether they result in the transfer of native units or not. As long as such transactions are recorded on the chain, they will be included in the calculation of this metric. Changes to the ledger algorithmically mandated by the protocol, such as coinbase transactions or post-launch new issuance, are not included here.

| Name   | MetricID | Unit         | Interval      |
| ------ | -------- | ------------ | ------------- |
| Tx Cnt | TxCnt    | Transactions | 1 day, 1 hour |

### Details

* For UTXO chains, this metric doesn’t include coinbase transactions.

### Asset Specific Details:

* For Solana, includes all successful and unsuccessful transactions, including vote transactions.

### Chart

<figure><img src="https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-09341f36f8a9624d358db1b6de4178b20ea265c8%2FCoin_Metrics_Network_Data_2022-09-15T15-16.png?alt=media" alt=""><figcaption><p>Source: Coin Metrics Network Data Chart</p></figcaption></figure>

### Release History

* Released in the 1.0 release of NDP

### Availability for Assets

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

## Tx per Second Cnt <a href="#txcntsec" id="txcntsec"></a>

### Definition

The sum count of transactions divided by the number of seconds that day.

| Name              | MetricID | Unit                    | Interval |
| ----------------- | -------- | ----------------------- | -------- |
| Tx per Second Cnt | TxCntSec | Transactions per second | 1 day    |

### Details

* Computed as TxCnt / 86400

### Asset Specific Details

* For Solana, includes vote transactions

### Release History

* Released in the 1.0 release of NDP

### Availability for Assets

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

## EIP1559 Tx Cnt <a href="#txcntsec" id="txcntsec"></a>

### Definition

The sum count of transactions that have natively adopted EIP-1559 features by featuring a Base Fee and Miner Tip.

EIP1559 introduced a host of changes to Ethereum's fee mechanism. While this proposal was implemented as a hard fork, not all wallets have adopted this new transaction type upon activation.

Transactions that are EIP1559-compliant have two portions: a Miner Tip and a Base Fee. Miner Tips represent the portion of the total transaction fees that rewards miners. This serves as an optinal incentive mechanism for miners to prioritize transactions that have opted-in and paid a tip. Base Fees, on the other hand, are mandatory and represent the minimum amount needed to be paid for a transaction to be included in a block. After inclusion, the Base Fee is effectively taken out of circulation, and it is burnt (destroyed).

| Name           | MetricID     | Unit         | Interval |
| -------------- | ------------ | ------------ | -------- |
| EIP1559 Tx Cnt | TxEIP1559Cnt | Transactions | 1 day    |

### Details

* EIP1559 was a highly anticipated proposal that changes how transaction fees are priced in Ethereum, as well as the dynamics of block sizes.
* The proposal activated on the Ethereum Network in August of 2021 and marks one of the biggest changes in monetary policy in the history of cryptoassets.
* Instead of the legacy *gas price*, 1559 splits transaction fees into two distinct fields: a Base Fee and an optional Tip (also known as a *Priority Fee*).
* This metric calculates the total number of native EIP-1559 transactions that have occurred in the network over the measuring period (e.g. 1 day).
* For a thorough review of EIP1559 and the design of its pricing mechanism, please refer to [this paper](https://arxiv.org/pdf/2012.00854.pdf).

### Chart

{% file src="<https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-09fab17d5c574f9e2c71de4e4cf67f3107bf6dfd%2FCoin_Metrics_Network_Data_2022-09-14T15-07.png?alt=media>" %}
Source: CM Network Data Charts
{% endfile %}

### Interpretation

* Not all wallets have implemented EIP-1559 upon activation, so this metric serves as a proxy for the native adoption of this new transaction type.
* While all transactions must abide by EIP-1559 at the blockchain consensus layer (and at the very least carry a Base Fee), not all wallets have natively adopted this transaction fomat.
* This metric serves a proxy to measure the native adoption of EIP1559 by wallets across the network.
* The ratio of TxEIP1559Cnt and Tx Cnt provides a view of the adoption of 1559 natively, relative to all other transactiosn that have taken place in the network.

### Release History

* Released in the 5.0 release of NDP (August, 2021)

### Availability for Assets

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

## Tx Mean Size <a href="#txmeanbyte" id="txmeanbyte"></a>

### Definition

The mean size (in bytes) per transaction for all transactions that interval.

| Name         | MetricID   | Unit  | Interval       |
| ------------ | ---------- | ----- | -------------- |
| Tx Mean Size | TxMeanByte | Bytes | 1 day, 1 block |

### Details

* Computed as BlkSizeByte / TxCnt

### Release History

* Released in the 1.0 release of NDP

### Availability for Assets

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

## OP\_RETURN Tx Cnt <a href="#txopretcnt" id="txopretcnt"></a>

### Definition

The sum count of transactions in that interval that included at least one OP\_RETURN output. OP\_RETURN outputs are used to embed data into the blockchain database.

| Name              | MetricID   | Unit         | Interval |
| ----------------- | ---------- | ------------ | -------- |
| OP\_RETURN Tx Cnt | TxOpRetCnt | Transactions | 1 day    |

### Details

* Coinbase (i.e., miner reward) transactions are not included.
* This metric is only available for Bitcoin and its forks/derivatives.

### Release History

* Version 4.2 of CM Network Data Pro Daily Macro (End of Day)

### Availability for Assets

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

## Shielded Tx Cnt <a href="#txshldcnt" id="txshldcnt"></a>

### Definition

The sum count of transactions using opt-in privacy features that interval. All privacy related features are included (including fully shielding, shielding, deshielding or mixed transactions). Transactions represent a bundle of intended actions to alter the ledger initiated by a user (human or machine). Shielding a transaction hides some or all of the activity described by it to a blockchain observer.

| Name            | MetricID  | Unit         | Interval |
| --------------- | --------- | ------------ | -------- |
| Shielded Tx Cnt | TxShldCnt | Transactions | 1 day    |

### Details

* Transactions in assets with opt-in privacy features can be of several types:
  * Fully shielding: all senders and all recipients are unknown
  * Shielding: all senders are known, all recipients are unknown
  * Deshielding: all senders are unknown, all recipients are known
  * Mixed: some senders are unknown or/and some recipients are unknown
  * Transparent: all senders and recipients are known
* This metric includes all transaction types except transparent

### Asset-Specific Details

* This metric is only available for assets that have opt-in privacy features like ZCash and its derivatives

### Release History

* Version 4.5 of CM Network Data Pro Daily Macro (End of Day)
* Date Last Modified: 2019-01-10

### Availability for Assets

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

## Fully Shielded Tx Cnt <a href="#txshldfullcnt" id="txshldfullcnt"></a>

### Definition

The sum count of transactions using fully shielding privacy features that interval. Only fully shielding transactions are included (transactions with partial or mixed shielding are not included). Transactions represent a bundle of intended actions to alter the ledger initiated by a user (human or machine). Fully shielding a transaction hides all of the activity of a transaction (except for the miner fee it paid).

| Name                  | MetricID      | Unit         | Interval |
| --------------------- | ------------- | ------------ | -------- |
| Fully Shielded Tx Cnt | TxShldFullCnt | Transactions | 1 day    |

### Details

* Transactions in assets with opt-in privacy features can be of several types:
  * Fully shielding: all senders and all recipients are unknown
  * Shielding: all senders are known, all recipients are unknown
  * Deshielding: all senders are unknown, all recipients are known
  * Mixed: some senders are unknown or/and some recipients are unknown
  * Transparent: all senders and recipients are known
* This metric includes all transaction types except transparent

### Asset-Specific Details

* This metric is only available for assets that have opt-in privacy features like ZCash and its derivatives

### Release History

* Version 4.5 of CM Network Data Pro Daily Macro (End of Day)
* Date Last Modified: 2019-01-10

### Availability for Assets

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

## Transactions, count, vote

### Definition

The sum count of non-voting transactions that interval on Solana. A subset of TxCnt.

| Name                      | MetricID  | Unit         | Interval |
| ------------------------- | --------- | ------------ | -------- |
| Transactions, count, vote | TxCntVote | Transactions | 1 day    |

### Details

* For Solana, count of all transactions on the Solana network that are vote transactions. Does not include other transactions.

### Release History

* Added as part of the first release of Solana metrics

### Availability for Assets

{% embed url="<https://coverage.coinmetrics.io/search-results?query=TxCntVote>" %}

## Transactions, count, nonvote

### Definition

The sum count of non-voting transactions that interval on Solana. A subset of TxCnt.

| Name                         | MetricID     | Unit         | Interval |
| ---------------------------- | ------------ | ------------ | -------- |
| Transactions, count, nonvote | TxCntNonvote | Transactions | 1 day    |

### Details

* For Solana, count of all transactions on the Solana network that are not vote transactions.

### Release History

* Added as part of the first release of Solana metrics

### Availability for Assets

{% embed url="<https://coverage.coinmetrics.io/search-results?query=TxCntNonvote>" %}

## MEV Transaction Count

<table><thead><tr><th width="177">Name</th><th width="157">MetricID</th><th width="124">Unit</th><th>Interval</th></tr></thead><tbody><tr><td>MEV Tx Cnt</td><td>MevTxCnt</td><td>Transactions</td><td>1 day</td></tr></tbody></table>

### Definition

The sum count of MEV-enabled transactions that interval. An MEV-enabled transaction is one that paid an MEV tip to miners/validators in exchange for specific block ordering.

### **Asset-Specific Details**

* For Solana, slots proposed by validators running the Jito-Solana client are considered as MEV slots. Further, in Solana it is possible to identify which transactions paid MEV tip in addition to simply identifying the slot. For this metric each individual transaction is evaluated to determine which are MEV-enabled and which aren't.

### Availability for Assets

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

## API Endpoints

Token Transaction metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `TxCnt`, `TxCntSec` etc. 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=TxCnt&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=TxCnt&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="TxCnt", 
        assets="eth",
    ).to_dataframe()
)
```

{% endtab %}
{% endtabs %}