Reported Volume
Last updated
Was this helpful?
Last updated
Was this helpful?
The reported volume aggregated across all exchanges in CM's coverage universe. These metrics do not use the to filter for the most accurate and trustworthy crypto exchanges. See for more details on the distinction for trustworthy exchanges.
Contents
The sum of all reported volume from the spot markets in Coin Metrics' coverage in units of U.S. dollars.
Reported Spot Volume
USD
1d
Reported Spot Volume, 1 Hour
USD
1h
Our reported volume metric is an aggregation of the reported volume from all exchanges in CM's coverage universe. Covered exchanges can be found .
A sample of the daily reported spot volume for Bitcoin is shown below:
btc
2021-07-25 00:00:00
7790004055.86305
btc
2021-07-26 00:00:00
27380811113.0087
btc
2021-07-27 00:00:00
16167140594.9998
btc
2021-07-28 00:00:00
19318207388.4525
asset. The IDs of the asset.
time. The reference rate time in ISO 8601 date-time format.
reported_trusted_spot_usd_1d. The reported volume value in units of U.S. dollars.
Release Version. Market Data Feed 2.4 (August 2021)
The sum of all reported future volume from the spot markets in Coin Metrics' coverage in units of U.S. dollars.
Reported Future Volume
USD
1d
Reported Future Volume, 1 Hour
USD
1h
Release Version. Market Data Feed 2.4 (August 2021)
Reported Perpetual Future Volume
USD
1d
Reported Perpetual Future Volume, 1 Hour
USD
1h
Release Version. Market Data Feed 2.4 (August 2021)
Reported Non-Perpetual Future Volume
USD
1d
Reported Non-Perpetual Future Volume, 1 Hour
USD
1h
Release Version. Market Data Feed 2.4 (August 2021)
Reported Coin-Margined Future Volume
USD
1d
Reported Coin-Margined Future Volume, 1 Hour
USD
1h
The sum of all reported volume from futures markets where the margin asset is Tether in units of U.S. dollars.
Reported Tether-Margined Future Volume
USD
1d
Reported Tether-Margined Future Volume, 1 Hour
USD
1h
Release Version. Market Data Feed 2.4 (August 2021)
All reported volume metrics can be queried using the following endpoints:
/timeseries/asset-metrics
/timeseries/exchange-metrics
/timeseries/exchange-asset-metrics
/timeseries/pair-metrics
and by passing in volume_reported_*
metric ID's in the the metrics
parameter.
Our reported future volume metric is an aggregation of the reported future volume from all futures exchanges in CM's coverage universe. Covered exchanges can be found .
The sum of all reported volume from perpetual futures markets in units of U.S. dollars.
Our perpetual future volume metric is an aggregation of the reported perpetual futures volume from all futures exchanges in CM's coverage universe. Covered exchanges can be found .
The sum of all reported volume from non-perpetual futures markets in units of U.S. dollars.
Our non-perpetual future volume metric is an aggregation of the reported non-perpetual futures volume from all futures exchanges in CM's coverage universe. Covered exchanges can be found .
The sum of all reported volume from futures markets where the margin asset is equivalent to the underlying base asset in units of U.S. dollars.
Our reported coin-margined future volume metric is an aggregation of the reported coin-margined future volume from all futures exchanges in CM's coverage universe. Covered exchanges can be found .
Our reported Tether-margined future volume metric is an aggregation of the reported Tether-margined future volume from all futures exchanges in CM's coverage universe. Covered exchanges can be found .
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:
Comma separated list of assets. Use the /catalog-all/assets endpoint for the full list of supported assets or specify asterisk (*) in order to get metrics for all supported assets.
Comma separated metrics to request time series data for. Information on all available metrics can be found on page https://coverage.coinmetrics.io/asset-metrics-v2. Use the /catalog-all/metrics or /catalog-all/assets endpoint for the full list of supported metrics per asset.
["AdrActCnt","BlkHgt"]
Frequency of the metrics. Supported values are 1b
(block by block), 1s
(one second), 1m
(one minute), 5m
(five minutes), 10m
(ten minutes), 1h
(one hour), 1d
(one day), 1d-ny-close
(one day at New York close time). Please refer to the /catalog/metrics
endpoint for the full list. Use the /catalog-all/assets endpoint for the full list of supported frequencies per asset-metric pair.
1d
Example: 1b
Which metric values do you want to see. Applicable only for "reviewable" metrics. You can find them in the /catalog/metrics
endpoint.
all
Available options: Start of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. Mutually exclusive with start_height
and start_hash
. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If start_time
is omitted, response will include time series from the earliest time available.
End of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. Mutually exclusive with end_height
and end_hash
. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If end_time
is omitted, response will include time series up to the latest time available.
The start height indicates the beginning block height for the set of data that are returned. Inclusive by default. Mutually exclusive with start_time
and start_hash
.
The end height indicates the ending block height for the set of data that are returned. Inclusive by default. Mutually exclusive with end_time
and end_hash
. This parameter is disabled for Community users.
The start hash indicates the beginning block height for the set of data that are returned. Inclusive by default. Mutually exclusive with start_time
and start_height
.
The end hash indicates the ending block height for the set of data that are returned. Inclusive by default. Mutually exclusive with end_time
and end_height
.
Inclusive or exclusive corresponding start_*
parameters.
true
Inclusive or exclusive corresponding end_*
parameters.
true
Specifies how many blocks behind the chain tip block by block metrics (1b
frequency) are based on. Default for btc
is 2
and 99
for eth
. For example, a min_confirmations
of 0
means metrics are being calculated for the block at the tip of the chain (the latest block received by our node) whereas a min_confirmations
of 6
means that metrics are being applied to the block that is 6
blocks behind the chain tip (i.e., the 7th block if the chain tip is block 1).
Timezone name for start_time
and end_time
timestamps. This parameter does not modify the output times, which are always UTC
. Format is defined by TZ database.
UTC
Example: America/New_York
Number of items per single page of results. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
100
Where does the first page start, at the start of the interval or at the end. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
end
Available options: How results will be sorted. Metrics with 1b
frequency are sorted by (asset, height, block_hash)
tuples by default. Metrics with other frequencies are sorted by (asset, time)
by default. If you want to sort 1d
metrics by (time, asset)
you should choose time
as value for the sort
parameter. Sorting by time
is useful if you request metrics for a set of assets.
asset
Available options: How many entries per asset result should contain. For example, this combination of parameters assets=btc,eth&metrics=ReferenceRate&limit_per_asset=1
returns the latest ReferenceRate
values for btc
and eth
.
Human-readable formatting of JSON responses.
false
Format of the response.
json
Available options: Nulls are represented as zeros in the response.
false
Token for receiving the results from the next page of a query. Should not be used directly. To iterate through pages just use next_page_url
response field.
Ignore "forbidden" errors for the items you currently don't have access to.
false
Ignore "unsupported" errors for not currently supported by Coin Metrics items.
false
Time series of asset metrics.
Returns metrics for specified exchanges. Results are ordered by tuple (exchange, time)
. To fetch the next page of results use next_page_url
JSON response field.
Comma separated list of exchange names or asterisk (*) for all supported exchanges.
{"summary":"the list of exchanges","value":"coinbase,binance,etc"}
Comma separated metrics to request time series data for. Information on all available metrics can be found on page https://coverage.coinmetrics.io/exchange-metrics-v2. Use the /catalog-all/exchange endpoint for the full list of supported metrics per exchange.
["open_interest_reported_future_usd","volume_reported_spot_usd_1d"]
Frequency of the exchange metrics. Supported values are 1h
, 1d
.
1d
Start of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If start_time
is omitted, response will include time series from the earliest time available.
End of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If end_time
is omitted, response will include time series up to the latest time available.
Inclusive or exclusive corresponding start_*
parameters.
true
Inclusive or exclusive corresponding end_*
parameters.
true
Timezone name for start_time
and end_time
timestamps. This parameter does not modify the output times, which are always UTC
. Format is defined by TZ database.
UTC
Example: America/New_York
Number of items per single page of results. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
100
Where does the first page start, at the start of the interval or at the end. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
end
Available options: How results will be sorted. Metrics are sorted by (exchange, time)
by default. If you want to sort 1d
metrics by (time, exchange)
you should choose time
as value for the sort
parameter. Sorting by time
is useful if you request metrics for a set of exchanges.
exchange
Available options: How many entries per institution result should contain. For example, this combination of parameters exchanges=binance,coinbase&metrics=volume_trusted_spot_usd_1h&limit_per_exchange=1
returns the latest volume_trusted_spot_usd_1h
values for binance
and coinbase
.
Human-readable formatting of JSON responses.
false
Format of the response.
json
Available options: Token for receiving the results from the next page of a query. Should not be used directly. To iterate through pages just use next_page_url
response field.
Time series of Exchange metrics.
Returns metrics for specified exchange-asset. Results are ordered by tuple (exchange_asset, time)
. To fetch the next page of results use next_page_url
JSON response field.
Comma separated list of exchange-asset pairs or patterns like exchange-*
or *-asset
.
Comma separated metrics to request time series data for. Information on all available metrics can be found on page https://coverage.coinmetrics.io/exchange-asset-metrics-v2. Use the /catalog-all/exchange-assets endpoint for the full list of supported metrics per exchange-asset combination.
["open_interest_reported_future_usd","volume_reported_spot_usd_1d"]
Frequency of the exchange-asset metrics. Supported values are 5m
, 1h
, 1d
.
1d
Start of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If start_time
is omitted, response will include time series from the earliest time available.
End of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If end_time
is omitted, response will include time series up to the latest time available.
Inclusive or exclusive corresponding start_*
parameters.
true
Inclusive or exclusive corresponding end_*
parameters.
true
Timezone name for start_time
and end_time
timestamps. This parameter does not modify the output times, which are always UTC
. Format is defined by TZ database.
UTC
Example: America/New_York
Number of items per single page of results. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
100
Where does the first page start, at the start of the interval or at the end. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
end
Available options: How results will be sorted. Metrics are sorted by (exchange_asset, time)
by default. If you want to sort 1d
metrics by (time, exchange_asset)
you should choose time
as value for the sort
parameter. Sorting by time
is useful if you request metrics for a set of exchange-assets.
exchange_asset
Available options: How many entries per exchange_asset result should contain. For example, this combination of parameters exchange_assets=binance-btc,coinbase-eth&metrics=volume_trusted_spot_usd_1h&limit_per_exchange_asset=1
returns the latest volume_trusted_spot_usd_1h
values for binance-btc
and coinbase-eth
.
Human-readable formatting of JSON responses.
false
Format of the response.
json
Available options: Token for receiving the results from the next page of a query. Should not be used directly. To iterate through pages just use next_page_url
response field.
Time series of exchange metrics.
Returns metrics for specified asset pairs. Results are ordered by tuple (pair, time)
. To fetch the next page of results use next_page_url
JSON response field.
Comma separated list of asset pairs or patterns like btc-*
, or *-btc
. Use the /catalog-all/pairs endpoint for the full list of supported asset pairs.
Comma separated metrics to request time series data for. Information on all available metrics can be found on page https://coverage.coinmetrics.io/pair-metrics-v2. Use the /catalog-all/pairs endpoint for the full list of supported metrics per pair.
["volume_trusted_spot_usd_1h","volume_trusted_spot_usd_1d"]
Frequency of the pair metrics. Supported values are 1h
, 1d
.
1d
Start of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If start_time
is omitted, response will include time series from the earliest time available.
End of the time interval. This field refers to the time
field in the response. Multiple formats of ISO 8601 are supported: 2006-01-20T00:00:00Z
, 2006-01-20T00:00:00.000Z
, 2006-01-20T00:00:00.123456Z
, 2006-01-20T00:00:00.123456789Z
, 2006-01-20
, 20060120
. Inclusive by default. UTC timezone by default. Z
suffix is optional and timezone
parameter has a priority over it. If end_time
is omitted, response will include time series up to the latest time available.
Inclusive or exclusive corresponding start_*
parameters.
true
Inclusive or exclusive corresponding end_*
parameters.
true
Timezone name for start_time
and end_time
timestamps. This parameter does not modify the output times, which are always UTC
. Format is defined by TZ database.
UTC
Example: America/New_York
Number of items per single page of results. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
100
Where does the first page start, at the start of the interval or at the end. The value of this parameter is ignored if the endpoint supports the format
parameter and its value is set to json_stream
.
end
Available options: How results will be sorted. Metrics are sorted by (pair, time)
by default. If you want to sort 1d
metrics by (time, pair)
you should choose time
as value for the sort
parameter. Sorting by time
is useful if you request metrics for a set of asset pairs.
pair
Available options: How many entries per pair result should contain. For example, this combination of parameters pair=btc-usd,eth-usd&metrics=volume_trusted_spot_usd_1h&limit_per_pair=1
returns the latest volume_trusted_spot_usd_1h
values for btc-usd
and eth-usd
.
Human-readable formatting of JSON responses.
false
Format of the response.
json
Available options: Token for receiving the results from the next page of a query. Should not be used directly. To iterate through pages just use next_page_url
response field.
Time series of pair metrics.