Fees

Fees

Contents

• Mempool Fee Sum (mempool_fee)

• Fees entered Mempool 1 minute (mempool_fee_entered_1m)

• Mempool Fees Mean (mempool_fee_mean)

• Mean Fees Entered Mempool 1 minute (mempool_fee_entered_1m)

• Mempool Fees Median (mempool_fee_median)

Mempool Fee Sum

Definition

The sum value of all mempool transaction fees at a point in time in native units.

Dictionary

Name	MetricID	Unit	Interval
Mempool Fee Sum	mempool_fee	Native units	1m

Methodology

The mempool is evaluated and all transactions indexed. The value of all transaction fees within these unprocessed transactions is then summed.

Available Assets

Bitcoin (BTC)

Sample Query

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

Fees entered Mempool 1 minute

Definition

The sum value of all mempool transaction fees for all transactions entering the mempool over the course of a 1-minute aggregation window. The beginning of this time window is noted in the “time” field of the response.

Dictionary

Name	MetricID	Unit	Interval
Fees entered mempool 1 minute	mempool_fee_entered_1m	Native units	1m

Methodology

The mempool is evaluated and the fees attached to all transactions that have been entered (new transactions broadcasted by users) in the previous 1-minute interval are counted.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mempool Fees Mean

Definition

The sum value of all mempool transaction fees at a point in time in native units.

Dictionary

Name	MetricID	Unit	Interval
Mempool Fees Mean	mempool_fee_mean	Native units	1m

Methodology

The mempool is evaluated and all transactions indexed. The mean value of all transaction fees within these unprocessed transactions is then calculated.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mean Fees Entered Mempool 1 minute

Definition

The mean value of the fees paid for all transactions entering the mempool over the course of a 1-minute aggregation window. The beginning of this time window is noted in the “time” field of the response.

Dictionary

Name	MetricID	Unit	Interval
Mean Fees entered mempool 1 minute	mempool_fee_mean_entered_1m	Native units	1m

Methodology

The mempool is evaluated and the fees attached to all transactions that have been entered (new transactions broadcasted by users) in the previous 1-minute interval are aggregated. The statistical mean of these fees is then calculated.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mempool Fees Median

Definition

The sum value of all mempool transaction fees at a point in time in native units.

Dictionary

Name	MetricID	Unit	Interval
Mempool Fees Median	mempool_fee_median	Native units	1m

Methodology

The mempool is evaluated and all transactions indexed. The median value of all transaction fees within these unprocessed transactions is then calculated.

Available Assets

Bitcoin (BTC)

Sample Query

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

API Endpoints

Fees metrics can be accessed using these endpoints:timeseries/asset-metricsand by passing in the metric ID's mempool_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=mempool_fee&assets=btc&pretty=true&api_key=<your_key>"

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=mempool_fee&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="mempool_fee", 
        assets="btc",
    ).to_dataframe()
)