> For the complete documentation index, see [llms.txt](https://gitbook-docs.coinmetrics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/market/price.md). # Price ### Contents * [Price, BTC](#btc-denominated-closing-price) * [Price, USD](#usd-denominated-closing-price) ## BTC Denominated Closing Price ### Definition The price of the asset denominated in Bitcoin units. | Name | MetricID | Unit | Interval | | --------------------- | -------- | ---- | ------------- | | BTC Denominated Price | PriceBTC | BTC | 1 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. {% embed url="" %} ## USD Denominated Closing Price ### Definition The price of the asset denominated in U.S. Dollars. | Name | MetricID | Unit | Interval | | ----------------------------- | -------- | ---- | --------------------- | | USD Denominated Closing Price | PriceUSD | USD | 1 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. {% embed url="" %} ### 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` `undefined/timeseries/asset-metrics` {% tabs %} {% tab title="Shell" %} ```shell curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PriceUSD&assets=btc&pretty=true&api_key=" ``` {% endtab %} {% tab title="Python" %} ```python import requests response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=PriceUSD&assets=btc&pretty=true&api_key=').json() print(response) ``` {% endtab %} {% tab title="Python Client" %} ```python from coinmetrics.api_client import CoinMetricsClient api_key = "" client = CoinMetricsClient(api_key) print( client.get_asset_metrics( metrics="PriceUSD", assets="btc", ).to_dataframe() ) ``` {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/market/price.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.