Transaction Fees

Contents

• Block Maximum Fees (block_fee_max)

• Block Mean Fees (block_fee_mean)

• Block Median Fees (block_fee_median)

• Block Minimum Fees (block_fee_min)

• Miner Fees per Block (block_fees)

Block Maximum Fees

Definition

Mined block's max transaction fee in native units.

Dictionary

Name	MetricID	Unit	Interval
Block Maximum Fees	block_fee_max	Native Currency	1 block

Methodology

The most recently-mined block is evaluated and the maximum of fees in that block is computed.

Available Assets

Bitcoin (BTC)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&metrics=block_fee_max&pretty=trueapi.coinmetrics.io

Block Mean Fees

Definition

Mined block's mean transaction fee in native units.

Dictionary

Name	MetricID	Unit	Interval
Block Mean Fees	block_fee_mean	Native Currency	1 block

Methodology

The most recently-mined block is evaluated and the mean of fees in that block is computed.

Available Assets

Bitcoin (BTC)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&metrics=block_fee_mean&pretty=trueapi.coinmetrics.io

Block Median Fees

Definition

Mined block's median transaction fee in native units.

Dictionary

Name	MetricID	Unit	Interval
Block Median Fees	block_fee_median	Native Currency	1 block

Methodology

The most recently-mined block is evaluated and the median of fees in that block is computed.

Available Assets

Bitcoin (BTC)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&metrics=block_fee_median&pretty=trueapi.coinmetrics.io

Block Minimum Fees

Definition

Mined block's minimum transaction fee in native units.

Dictionary

Name	MetricID	Unit	Interval
Block Minimum Fees	block_fee_min	Native Currency	1 block

Methodology

The most recently-mined block is evaluated and the minimum of fees in that block is computed.

Available Assets

Bitcoin (BTC)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&metrics=block_fee_min&pretty=trueapi.coinmetrics.io

Miner Fees per Block

Definition

The sum of fees paid to miners for the transactions included in each mined block.

Dictionary

Name	MetricID	Unit	Interval
Miner Fees per block	block_fees	Difficulty	1 block

Methodology

The most recently-mined block is evaluated and the sum of fees in that block is computed.

Available Assets

Bitcoin (BTC), Ethereum (ETH)*

* Historical data covering the pre-merge timeframe only (up to 9/15/2022). With the merge ETH switched from Proof of Work and miners to Proof of Stake and validators meaning the miner fees per block are non-existent post the merge date for Ethereum.

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&limit_per_asset=1&metrics=block_fees&pretty=trueapi.coinmetrics.io

API Endpoints

metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's block_fee* in the metrics parameter.

Asset metrics

Returns requested metrics for specified assets. Results for block by block metrics (1b frequency) are ordered by tuple (asset, height, block_hash), all other metrics are ordered by tuple (asset, time). You can change the sorting using sort query parameter. Supported output formats are json (default) and csv, use format query parameter to override it. To fetch the next page of results use next_page_url JSON response field or x-next-page-url CSV HTTP header if present. If multiple metrics are requested in the same time the strict policy for partially available metrics among requested ones is applied:

GEThttps://api.coinmetrics.io/v4/timeseries/asset-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of metrics for an asset.

Body

application/jsontext/csv

data*any

next_page_tokenNextPageToken (string)

Token of the next page results for a given request.

next_page_urlNextPageUrl (string)

URL of the next page results for a given request.

Response

200400401403

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

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

Python

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

Python Client

from coinmetrics.api_client import CoinMetricsClient

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

print(
    client.get_asset_metrics(
        metrics="block_fees", 
        assets="btc",
    ).to_dataframe()
)