Transaction Sizes

Contents

• Mempool Size

• Mempool Size Entered

• Mempool Size Left

• Mempool vSize

• Mempool vSize Entered

• Mempool vSize Left

Mempool Size

Definition

The total size of all transactions in the mempool, in bytes.

Dictionary

Name	MetricID	Unit	Interval
Mempool Size	mempool_size	bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The size of all transactions is summed.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mempool Size Entered

Definition

The total size in bytes of all transactions that have entered 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
Mempool Size Entered 1m	mempool_size_entered_1m	bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The size of all transactions that have entered the mempool in the previous 1-minute window is summed.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mempool Size Left

Definition

The total size in bytes of all transactions that have left 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
Mempool Size Left 1m	mempool_size_left_1m	bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The size of all transactions that have left the mempool in the previous 1-minute window is summed.

Available Assets

Bitcoin (BTC)

Sample Query

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

Mempool vSize

Definition

The total virtual size (vsize) of all transactions in the mempool, in virtual bytes. Virtual Size (vsize) is a unit used to measure the size of bitcoin transactions after the activation of SegWit.

Dictionary

Name	MetricID	Unit	Interval
Mempool vsize	mempool_vsize	Virtual bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The virtual size of all transactions is 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_vsize&pretty=trueapi.coinmetrics.io

Mempool vSize Entered

Definition

The total virtual size (vsize) of all transactions that have entered 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. Virtual Size (vsize) is a unit used to measure the size of a bitcoin transaction after the activation of SegWit.

Dictionary

Name	MetricID	Unit	Interval
Mempool vsize entered 1 minute	mempool_vsize_entered_1m	Virtual bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The virtual size of all transactions that have entered the mempool in the previous 1-minute window is 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_vsize_entered_1m&pretty=trueapi.coinmetrics.io

Mempool vSize Left

Definition

The total virtual size (vsize), in bytes, of all transactions that have left 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. Virtual Size (vsize) is a unit used to measure the size of a bitcoin transaction after the activation of SegWit.

Dictionary

Name	MetricID	Unit	Interval
Mempool vsize left 1 minute	mempool_vsize_left_1m	Virtual bytes	1m

Methodology

The mempool is evaluated and all transactions within are indexed. The virtual size of all transactions that have left the mempool in the previous 1-minute window is 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_vsize_left_1m&pretty=trueapi.coinmetrics.io

API Endpoints

metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's mempool_size* and mempool_vsize_* 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=mempool_size&assets=btc&pretty=true&api_key=<your_key>"

Python

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