Skip to main content

Price

Contents​

BTC Denominated Closing Price​

Definition​

The price of the asset denominated in Bitcoin units.

NameMetricIDUnitInterval
BTC Denominated PricePriceBTCBTC1 day, 1 hour

Details​

  • This metric is available in both daily and block frequencies. The daily frequency represents the price as of the end of the day in UTC time. The block frequency represents the price at the time the block was added to the blockchain.\
  • This metric is identical to ReferenceRateBTC but with different timestamp conventions. Please see the frequently asked questions below for more information on this topic.\
  • This price is computed using our CM Reference Rates. Please see our CM Prices Overview for more information on methodology and policies.

Example​

A sample of the PriceBTC metric for Ethereum with daily frequency is shown below:

{
"data" : [ {
"asset" : "eth",
"time" : "2023-03-18T00:00:00.000000000Z",
"PriceBTC" : "0.06538140200862749"
}, {
"asset" : "eth",
"time" : "2023-03-19T00:00:00.000000000Z",
"PriceBTC" : "0.06392540140433825"
}, {
"asset" : "eth",
"time" : "2023-03-20T00:00:00.000000000Z",
"PriceBTC" : "0.062418493975669356"
}, {
"asset" : "eth",
"time" : "2023-03-21T00:00:00.000000000Z",
"PriceBTC" : "0.06407211604389325"
}, {
"asset" : "eth",
"time" : "2023-03-22T00:00:00.000000000Z",
"PriceBTC" : "0.06357608845321447"
}
}

A sample of the PriceBTC metric for Ethereum with block frequency is shown below:

{
"data" : [ {
"block_hash" : "cf604b220ea0f3fba67244573f33a36919b6cf2ff7ea210a86377d229bb9b0d8",
"parent_block_hash" : "152ca610b2f68643c43dd82dcdb79519ee26f490cf29c14456ac23f9489eaa1b",
"height" : "16890992",
"asset" : "eth",
"time" : "2023-03-23T15:01:35.000000000Z",
"PriceBTC" : "0.06447664"
}, {
"block_hash" : "7f279840f5f4cf23a7a6c880531f1dd2858b2a6ad220dc7123600c064c700db9",
"parent_block_hash" : "cf604b220ea0f3fba67244573f33a36919b6cf2ff7ea210a86377d229bb9b0d8",
"height" : "16890993",
"asset" : "eth",
"time" : "2023-03-23T15:01:47.000000000Z",
"PriceBTC" : "0.0644538"
}, {
"block_hash" : "2051a0dba9018764e8469f4f5de4845c5c7333e34b84e258f088f6b7ceb5369e",
"parent_block_hash" : "7f279840f5f4cf23a7a6c880531f1dd2858b2a6ad220dc7123600c064c700db9",
"height" : "16890994",
"asset" : "eth",
"time" : "2023-03-23T15:01:59.000000000Z",
"PriceBTC" : "0.0644743"
}, {
"block_hash" : "fb45b96b4527c535a957754ef81b603e878da31d05f20010497914177cd0c2b0",
"parent_block_hash" : "2051a0dba9018764e8469f4f5de4845c5c7333e34b84e258f088f6b7ceb5369e",
"height" : "16890995",
"asset" : "eth",
"time" : "2023-03-23T15:02:11.000000000Z",
"PriceBTC" : "0.06449479"
}, {
"block_hash" : "e5f672e9accdcedc0c319de63037a25102b47efdfd794bf4e3e5124bcc20b8c4",
"parent_block_hash" : "fb45b96b4527c535a957754ef81b603e878da31d05f20010497914177cd0c2b0",
"height" : "16890996",
"asset" : "eth",
"time" : "2023-03-23T15:02:23.000000000Z",
"PriceBTC" : "0.06443347"
}
}
  • asset: The ID of the asset.\
  • time: The reference rate time in ISO 8601 date-time format.\
  • PriceBTC: The published reference rate value in Bitcoin units.\
  • block_hash: The hash of the block.\
  • parent_block_hash: The hash of the parent block.\
  • height: The block height.

Release History​

  • Released in the version 1.0 release of NDP

Availability for Assets​

Please see our Coin Metrics Coverage below for our asset coverage universe.

Embedded content

USD Denominated Closing Price​

Definition​

The price of the asset denominated in U.S. Dollars.

NameMetricIDUnitInterval
USD Denominated Closing PricePriceUSDUSD1 day, 1block, 1 hour

Details​

  • This metric is available in both daily and block frequencies. The daily frequency represents the price as of the end of the day in UTC time. The block frequency represents the price at the time the block was added to the blockchain.\
  • This metric is identical to ReferenceRate and ReferenceRateUSD but with different timestamp conventions. Please see the frequently asked questions below for more information on this topic.\
  • This price is computed using our CM Reference Rates. Please see our CM Prices Overview for more information on methodology and policies.

Example​

A sample of the PriceUSD metric for Bitcoin with daily frequency is shown below:

{
"data" : [ {
"asset" : "btc",
"time" : "2023-03-18T00:00:00.000000000Z",
"PriceUSD" : "26985.7359915254"
}, {
"asset" : "btc",
"time" : "2023-03-19T00:00:00.000000000Z",
"PriceUSD" : "28185.2043319696"
}, {
"asset" : "btc",
"time" : "2023-03-20T00:00:00.000000000Z",
"PriceUSD" : "27834.3361090006"
}, {
"asset" : "btc",
"time" : "2023-03-21T00:00:00.000000000Z",
"PriceUSD" : "28172.7950558153"
}, {
"asset" : "btc",
"time" : "2023-03-22T00:00:00.000000000Z",
"PriceUSD" : "27341.5571297487"
}
}

A sample of the PriceUSD metric for Bitcoin with block frequency is shown below:

{
"data" : [ {
"block_hash" : "000000000000000000061ade334ac0403c9473001639a16d4ff93bb822d30e92",
"parent_block_hash" : "00000000000000000003c4583ecf8f90eefc404e8fb42e035649b7ed3010936d",
"height" : "782143",
"asset" : "btc",
"time" : "2023-03-23T13:33:46.000000000Z",
"PriceUSD" : "27520.25"
}, {
"block_hash" : "000000000000000000063ca1e45712d631ae9daa0bca98fd2d42229471d5abd6",
"parent_block_hash" : "000000000000000000061ade334ac0403c9473001639a16d4ff93bb822d30e92",
"height" : "782144",
"asset" : "btc",
"time" : "2023-03-23T13:36:23.000000000Z",
"PriceUSD" : "27493.35"
}, {
"block_hash" : "000000000000000000040f8e246619bea33b4e22a4f797daa78ef721c727885f",
"parent_block_hash" : "000000000000000000063ca1e45712d631ae9daa0bca98fd2d42229471d5abd6",
"height" : "782145",
"asset" : "btc",
"time" : "2023-03-23T13:48:09.000000000Z",
"PriceUSD" : "27404.86"
}, {
"block_hash" : "0000000000000000000391940aa48790413a38ec3834d299a05eaaa797f2336b",
"parent_block_hash" : "000000000000000000040f8e246619bea33b4e22a4f797daa78ef721c727885f",
"height" : "782146",
"asset" : "btc",
"time" : "2023-03-23T13:49:45.000000000Z",
"PriceUSD" : "27384.94"
}, {
"block_hash" : "000000000000000000006b582725ac8e609305e3b5643afe0a92205220cf7fa6",
"parent_block_hash" : "0000000000000000000391940aa48790413a38ec3834d299a05eaaa797f2336b",
"height" : "782147",
"asset" : "btc",
"time" : "2023-03-23T14:20:06.000000000Z",
"PriceUSD" : "27463"
}
}
  • asset: The ID of the asset.\
  • time: The reference rate time in ISO 8601 date-time format.\
  • PriceUSD: The published reference rate value in U.S. Dollars.\
  • block_hash: The hash of the block.\
  • parent_block_hash: The hash of the parent block.\
  • height: The block height.

Release History​

  • Released in the version 1.0 release of NDP

Availability for Assets​

Please see our Coin Metrics Coverage below for our asset coverage universe.

Embedded content

API Endpoints​

Exhange Deposits metrics can be accessed using these endpoints:

  • timeseries/asset-metrics

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

GET /timeseries/asset-metrics

Asset metrics

View endpoint and parameters

Shell
curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PriceUSD&assets=btc&pretty=true&api_key=<your_key>"
Python
import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PriceUSD&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="PriceUSD",
assets="btc",
).to_dataframe()
)