Transaction Feerates

Contents

• Block Maximum Feerate

• Block Mean Feerate

• Block Median Feerate

• Block Minimum Feerate

Block Maximum Feerate

Definition

A block's maximum transaction feerate. For Bitcoin this is measured in sats/vbyte. For Ethereum this measures the gas price in Gwei

Dictionary

Name	MetricID	Unit	Interval
Block Maximum Feerate	block_feerate_max	Native feerate	1 block

Methodology

The most recent block is evaluated and the maximum feerate in that block is computed.

Available Assets

Bitcoin (BTC), Ethereum (ETH)

Sample Query

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

Block Mean Feerate

Definition

A block's mean transaction feerate. For Bitcoin this is measured in sats/vbyte. For Ethereum this measures the gas price in Gwei

Dictionary

Name	MetricID	Unit	Interval
Block Mean Feerate	block_feerate_mean	Native feerate	1 block

Methodology

The most recent block is evaluated and the mean feerate in that block is computed.

Available Assets

Bitcoin (BTC), Ethereum (ETH)

Sample Query

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

Block Median Feerate

Definition

A block's median transaction feerate. For Bitcoin this is measured in sats/vbyte. For Ethereum this measures the gas price in Gwei

Dictionary

Name	MetricID	Unit	Interval
Block Median Feerate	block_feerate_median	Native feerate	1 block

Methodology

The most recent block is evaluated and the median feerate in that block is computed.

Available Assets

Bitcoin (BTC), Ethereum (ETH)

Sample Query

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

Block Minimum Feerate

Definition

A block's minimum transaction feerate. For Bitcoin this is measured in sats/vbyte. For Ethereum this measures the gas price in Gwei

Dictionary

Name	MetricID	Unit	Interval
Block Minimum Feerate	block_feerate_min	Native feerate	1 block

Methodology

The most recent block is evaluated and the minimum feerate in that block is computed.

Available Assets

Bitcoin (BTC), Ethereum (ETH)

Sample Query

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

API Endpoints

Transaction Feerate metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's block_feerate_* 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.

Request

ShellPython

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?assets=btc&metrics=PriceUSD,FlowInGEMUSD&frequency=1d&pretty=true&api_key=<your_key>"

Response

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

Shell

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

Python

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