# BTC Network Indicator

This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric.

## Stock to Flow

> Stock to Flow is a metric used to assume bitcoin price based on its scarcity just like gold, silver, and other valuable objects that are limited in amount and costly to earn. The same model for evaluating the value of those objects can be adopted to assess the value of bitcoin. The scarcity is calculated by dividing currently circulating coins in the blockchain network to newly supplied coins.  \
> \_\_\[Go to Data Guide‣]\(<https://dataguide.cryptoquant.com/network-indicators/stock-to-flow-ratio)\\_\\>\_<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"stocktoflow":{"description":"stock_to_flow, stock_to_flow_reversion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockToFlowResponse"}}}}},"schemas":{"StockToFlowResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["stock_to_flow","stock_to_flow_reversion"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"stock_to_flow":{"type":"decimal","description":"Stock to Flow is a ratio of currently circulating BTC divided by newly supplied BTC."},"stock_to_flow_reversion":{"type":"decimal","description":"Stock to Flow Reversion is used to spot market bottoms. It is calculated by dividing the price of bitcoin to its stock-to-flow ratio."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/stock-to-flow":{"get":{"tags":["BTC Network Indicator"],"summary":"Stock to Flow","description":"Stock to Flow is a metric used to assume bitcoin price based on its scarcity just like gold, silver, and other valuable objects that are limited in amount and costly to earn. The same model for evaluating the value of those objects can be adopted to assess the value of bitcoin. The scarcity is calculated by dividing currently circulating coins in the blockchain network to newly supplied coins.  \n__[Go to Data Guide‣](https://dataguide.cryptoquant.com/network-indicators/stock-to-flow-ratio)__\n","operationId":"getStockToFlow","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/stocktoflow"}}}}}}
```

## NVT

> NVT(Network Value to Transaction) ratio is the network value(\`supply\_total\` \* \`price\_usd\`) divided by \`tokens\_transferred\_total\`. \`nvt\` is a metric often used to determine whether Bitcoin price is overvalued or not. The theory behind this indicator is that the value of the token depends on how actively transactions take place on the network.  \
> \_\_\[Go to Data Guide‣]\(<https://dataguide.cryptoquant.com/network-indicators/nvt-ratio)\\_\\>\_<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_d":{"description":"Currently, we only support `day`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"nvt":{"description":"NVT(Network Value to Transaction) ratio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVTResponse"}}}}},"schemas":{"NVTResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_D"},"data":{"type":"array","items":{"type":"object","required":["nvt"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"nvt":{"type":"decimal","description":"NVT(Network Value to Transaction) ratio is the network value(supply_total) divided by tokens_transferred_total."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_D":{"type":"string","description":"The size of window. This metric supports only day resolution."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."}}},"paths":{"/btc/network-indicator/nvt":{"get":{"tags":["BTC Network Indicator"],"summary":"NVT","description":"NVT(Network Value to Transaction) ratio is the network value(`supply_total` * `price_usd`) divided by `tokens_transferred_total`. `nvt` is a metric often used to determine whether Bitcoin price is overvalued or not. The theory behind this indicator is that the value of the token depends on how actively transactions take place on the network.  \n__[Go to Data Guide‣](https://dataguide.cryptoquant.com/network-indicators/nvt-ratio)__\n","operationId":"getNetworkIndicatorNVT","parameters":[{"$ref":"#/components/parameters/window_d"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/nvt"}}}}}}
```

## NVT Golden Cross

> NVT Golden Cross is a modified index of NVT that provides local tops and bottoms. NVT Golden Cross values above 2.2 indicate that downside risk goes up. NVT Golden Cross values below -1.6 mean huge upside potential will occur.  \
> \_\_\[Go to Data Guide‣]\(<https://dataguide.cryptoquant.com/network-indicators/nvt-golden-cross)\\_\\>\_<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_d":{"description":"Currently, we only support `day`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"nvt_golden_cross":{"description":"nvt_golden_cross","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVTGoldenCrossResponse"}}}}},"schemas":{"NVTGoldenCrossResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_D"},"data":{"type":"array","items":{"type":"object","required":["nvt_golden_cross"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"nvt_golden_cross":{"type":"decimal","description":"NVT Golden Cross is a modified index of NVT. NVT Golden Cross value will return null if std is 0."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_D":{"type":"string","description":"The size of window. This metric supports only day resolution."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."}}},"paths":{"/btc/network-indicator/nvt-golden-cross":{"get":{"tags":["BTC Network Indicator"],"summary":"NVT Golden Cross","description":"NVT Golden Cross is a modified index of NVT that provides local tops and bottoms. NVT Golden Cross values above 2.2 indicate that downside risk goes up. NVT Golden Cross values below -1.6 mean huge upside potential will occur.  \n__[Go to Data Guide‣](https://dataguide.cryptoquant.com/network-indicators/nvt-golden-cross)__\n","operationId":"getNVTGoldenCross","parameters":[{"$ref":"#/components/parameters/window_d"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/nvt_golden_cross"}}}}}}
```

## NVM

> NVM(Network Value to Metcalfe Ratio) is a metric based on Metcalfe’s law; the value of a network is proportional to the square of its nodes or user. NVM is a ratio of market cap divided by daily active address. Based on Metcalfe’s law, the value of bitcoin rises if the daily active addresses increase. Therefore, if the NVM value is relatively small, it means that the value of the network is underestimated and if the value is relatively high, it means that the value of the network is overestimated.  \
> \_\_\[Go to Data Guide‣]\(<https://dataguide.cryptoquant.com/network-indicators/nvm-ratio)\\_\\>\_<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_d":{"description":"Currently, we only support `day`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"nvm":{"description":"nvm","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVMResponse"}}}}},"schemas":{"NVMResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_D"},"data":{"type":"array","items":{"type":"object","required":["nvm"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"nvm":{"type":"decimal","description":"NVM is a ratio of market cap divided by daily active address."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_D":{"type":"string","description":"The size of window. This metric supports only day resolution."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."}}},"paths":{"/btc/network-indicator/nvm":{"get":{"tags":["BTC Network Indicator"],"summary":"NVM","description":"NVM(Network Value to Metcalfe Ratio) is a metric based on Metcalfe’s law; the value of a network is proportional to the square of its nodes or user. NVM is a ratio of market cap divided by daily active address. Based on Metcalfe’s law, the value of bitcoin rises if the daily active addresses increase. Therefore, if the NVM value is relatively small, it means that the value of the network is underestimated and if the value is relatively high, it means that the value of the network is overestimated.  \n__[Go to Data Guide‣](https://dataguide.cryptoquant.com/network-indicators/nvm-ratio)__\n","operationId":"getNVM","parameters":[{"$ref":"#/components/parameters/window_d"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/nvm"}}}}}}
```

## Puell Multiple

> Puell Multiple is the mining revenue usd divided by MA 365 mining revenue usd. \`puell\_multiple\` is a metric shows the historically low and high periods of the value of bitcoin issued daily, and at what point investors should buy bitcoin to get high returns. This indicator was created by David Puell.  \
> \_\_\[Go to Data Guide‣]\(<https://dataguide.cryptoquant.com/network-indicators/puell-multiple)\\_\\>\_<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_d":{"description":"Currently, we only support `day`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"puell_multiple":{"description":"puell_multiple","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PuellMultipleResponse"}}}}},"schemas":{"PuellMultipleResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_D"},"data":{"type":"array","items":{"type":"object","required":["puell_multiple"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"puell_multiple":{"type":"decimal","description":"Puell Multiple is the mining revenue usd divided by MA 365 mining revenue usd."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_D":{"type":"string","description":"The size of window. This metric supports only day resolution."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."}}},"paths":{"/btc/network-indicator/puell-multiple":{"get":{"tags":["BTC Network Indicator"],"summary":"Puell Multiple","description":"Puell Multiple is the mining revenue usd divided by MA 365 mining revenue usd. `puell_multiple` is a metric shows the historically low and high periods of the value of bitcoin issued daily, and at what point investors should buy bitcoin to get high returns. This indicator was created by David Puell.  \n__[Go to Data Guide‣](https://dataguide.cryptoquant.com/network-indicators/puell-multiple)__\n","operationId":"getPuellMultiple","parameters":[{"$ref":"#/components/parameters/window_d"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/puell_multiple"}}}}}}
```

## Coin Days Destroyed

> Coin Days Destroyed reflects market participants who have been in the bitcoin on-chain for longer. This indicator gives more weight to long-term-holder position.\
> \`cdd\` is the sum of products of spent transaction output alive days and its value.\
> \`sa\_cdd\` is abbreviation of supply-adjusted cdd.\
> Since \`cdd\` increases as the newly created block mined, we need an indicator which normalize \`cdd\` value. \`sa\_cdd\` is calculated by \`cdd\` over \`supply\_total\`.\
> \`average\_sa\_cdd\` is the average value of \`sa\_cdd\` since genesis block.\
> \`binary\_cdd\` is the signal whether current \`sa\_cdd\` is larger than \`average\_sa\_cdd\` or not. If \`sa\_cdd\` > \`average\_sa\_cdd\`, then \`binary\_cdd\` is 1.\
> In conclusion, these indicators help us to estimate how whale's moving.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"cdd":{"description":"cdd","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CDDResponse"}}}}},"schemas":{"CDDResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["cdd","a_cdd","sa_cdd","average_sa_cdd","binary_cdd"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"cdd":{"type":"decimal","description":"When UTxO destroyed, Coin Days Destroyed is calculated as the sum value of the number of days between created and spent multiplied by UTxO amount."},"sa_cdd":{"type":"decimal","description":"Supply Adjusted Coin Days Destroyed is `cdd` value adjusted by supply. It is calculated as the value of `cdd` divided by total supply."},"average_sa_cdd":{"type":"decimal","description":"Average Supply Adjusted Coin Days Destroyed is the historical average value of `sa_cdd` after generation block."},"binary_cdd":{"type":"integer","description":"Binary Coin Days Destroyed is binary value. When `sa_cdd` is larger than `average_sa_cdd`, `binary_cdd` is 1."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/cdd":{"get":{"tags":["BTC Network Indicator"],"summary":"Coin Days Destroyed","description":"Coin Days Destroyed reflects market participants who have been in the bitcoin on-chain for longer. This indicator gives more weight to long-term-holder position.\n`cdd` is the sum of products of spent transaction output alive days and its value.\n`sa_cdd` is abbreviation of supply-adjusted cdd.\nSince `cdd` increases as the newly created block mined, we need an indicator which normalize `cdd` value. `sa_cdd` is calculated by `cdd` over `supply_total`.\n`average_sa_cdd` is the average value of `sa_cdd` since genesis block.\n`binary_cdd` is the signal whether current `sa_cdd` is larger than `average_sa_cdd` or not. If `sa_cdd` > `average_sa_cdd`, then `binary_cdd` is 1.\nIn conclusion, these indicators help us to estimate how whale's moving.\n","operationId":"getCDD","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/cdd"}}}}}}
```

## Mean Coin Age

> Mean Coin Age is the mean value of products of bitcoin unspent transaction output alive days and its value.\
> It is basically similar to \`cdd\`. But \`mca\` focuses on unspent transaction output.\
> Mean Coin Dollar Age is the sum value of products of bitcoin unspent transaction output alive days, value, and price at the created time.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"mca":{"description":"mca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCAResponse"}}}}},"schemas":{"MCAResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["mca","mcda"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"mca":{"type":"decimal","description":"Mean Coin Age is the mean value of products of bitcoin unspent transaction output alive days and its value."},"mcda":{"type":"decimal","description":"Mean Coin Dollar Age is the mean value of products of bitcoin unspent transaction output alive days, value, and price at the created time."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/mca":{"get":{"tags":["BTC Network Indicator"],"summary":"Mean Coin Age","description":"Mean Coin Age is the mean value of products of bitcoin unspent transaction output alive days and its value.\nIt is basically similar to `cdd`. But `mca` focuses on unspent transaction output.\nMean Coin Dollar Age is the sum value of products of bitcoin unspent transaction output alive days, value, and price at the created time.\n","operationId":"getMCA","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/mca"}}}}}}
```

## Sum Coin Age

> Sum Coin Age is the sum value of products of bitcoin unspent transaction output alive days and its value.\
> It is basically similar to \`cdd\`. But \`sca\` focuses on unspent transaction output.\
> Sum Coin Dollar Age is the sum value of products of bitcoin unspent transaction output alive days, value, and price at the created time.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"sca":{"description":"sca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SCAResponse"}}}}},"schemas":{"SCAResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["sca","scda"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"sca":{"type":"decimal","description":"Sum Coin Age is the sum value of products of bitcoin unspent transaction output alive days and its value."},"scda":{"type":"decimal","description":"Sum Coin Dollar Age is the sum value of products of bitcoin unspent transaction output alive days, value, and price at the created time."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/sca":{"get":{"tags":["BTC Network Indicator"],"summary":"Sum Coin Age","description":"Sum Coin Age is the sum value of products of bitcoin unspent transaction output alive days and its value.\nIt is basically similar to `cdd`. But `sca` focuses on unspent transaction output.\nSum Coin Dollar Age is the sum value of products of bitcoin unspent transaction output alive days, value, and price at the created time.\n","operationId":"getSCA","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/sca"}}}}}}
```

## Sum Coin Age Distribution

> This indicator shows the distribution of long-term holder and short-term holder with UTxO data.\
> It is similar to UTxO distribution, but weighted by alive days to highlight long-term holder's distribution in different ranges.\
> Each field is calculated as the sum of the products of bitcoin unspent transaction output alive days and its value in a given period, divided by their sum.\
> If long-term SCA distribution ratio increases, then we can interpret this as one of bullish moment.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"sca-distribution":{"description":"sca-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SCADistributionResponse"}}}}},"schemas":{"SCADistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["range_0d_1d","range_1d_1w","range_1w_1m","range_1m_3m","range_3m_6m","range_6m_12m","range_12m_18m","range_18m_2y","range_2y_3y","range_3y_5y","range_5y_7y","range_7y_10y","range_10y_inf","range_0d_1d_percent","range_1d_1w_percent","range_1w_1m_percent","range_1m_3m_percent","range_3m_6m_percent","range_6m_12m_percent","range_12m_18m_percent","range_18m_2y_percent","range_2y_3y_percent","range_3y_5y_percent","range_5y_7y_percent","range_7y_10y_percent","range_10y_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"range_0d_1d":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is less than 1 day."},"range_1d_1w":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 1 day and less than 7 days."},"range_1w_1m":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 7 days and less than 1 month."},"range_1m_3m":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 1 month and less than 3 months."},"range_3m_6m":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 3 months and less than 6 months."},"range_6m_12m":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 6 months and less than 12 months."},"range_12m_18m":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 12 months and less than 18 months."},"range_18m_2y":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 18 months and less than 2 years."},"range_2y_3y":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 2 years and less than 3 years."},"range_3y_5y":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 3 years and less than 5 years."},"range_5y_7y":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 5 years and less than 7 years."},"range_7y_10y":{"type":"decimal","description":"Sum Coin Age distribution value of which alive time is more than 7 years and less than 10 years."},"range_10y_inf":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 10 years."},"range_0d_1d_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is less than 1 day."},"range_1d_1w_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 1 day and less than 7 days."},"range_1w_1m_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 7 days and less than 1 month."},"range_1m_3m_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 1 month and less than 3 months."},"range_3m_6m_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 3 months and less than 6 months."},"range_6m_12m_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 6 months and less than 12 months."},"range_12m_18m_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 12 months and less than 18 months."},"range_18m_2y_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 18 months and less than 2 years."},"range_2y_3y_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 2 years and less than 3 years."},"range_3y_5y_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 3 years and less than 5 years."},"range_5y_7y_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 5 years and less than 7 years."},"range_7y_10y_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 7 years and less than 10 years."},"range_10y_inf_percent":{"type":"decimal","description":"Sum Coin Age distribution percent value of which alive time is more than 10 years."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/sca-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"Sum Coin Age Distribution","description":"This indicator shows the distribution of long-term holder and short-term holder with UTxO data.\nIt is similar to UTxO distribution, but weighted by alive days to highlight long-term holder's distribution in different ranges.\nEach field is calculated as the sum of the products of bitcoin unspent transaction output alive days and its value in a given period, divided by their sum.\nIf long-term SCA distribution ratio increases, then we can interpret this as one of bullish moment.\n","operationId":"getSCADistribution","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/sca-distribution"}}}}}}
```

## Net Unrealized Profit and Loss

> Net Unrealized Profit and Loss shows how different between \`market\_cap\` and \`realized\_cap\`.\
> \`nupl\` is calculated as difference between \`market\_cap\` and \`realized\_cap\` divided by \`market\_cap\`.\
> If \`market\_cap\` > \`realized\_cap\`, then \`nupl\` > 0, which means bitcoin on-chain expected value is less than what they actually have.\
> So this value will give selling pressure.\
> \`nup\` is net unrealized profit, which is calculated as sum of products of UTxO's value and price difference between created and destroyed, divided by \`market\_cap\`.\
> \`nup\` only contains UTxOs in profit.\
> \`nul\` is net unrealized loss. This is opposite indicator of \`nup\`.\
> It only contains UTxOs in loss.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"nupl":{"description":"nupl","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NUPLResponse"}}}}},"schemas":{"NUPLResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["nupl","nup","nul"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"nupl":{"type":"decimal","description":"Net Unrealized Profit and Loss is the difference between `market_cap` and `realized_cap` divided by `market_cap`."},"nup":{"type":"decimal","description":"Net Unrealized Profit is the sum of products of UTxO's value and price difference between created and destroyed only in profit, divided by `market_cap`."},"nul":{"type":"decimal","description":"Net Unrealized Loss is the sum of products of UTxO's value and price difference between created and destroyed only in loss, divided by `market_cap`."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/nupl":{"get":{"tags":["BTC Network Indicator"],"summary":"Net Unrealized Profit and Loss","description":"Net Unrealized Profit and Loss shows how different between `market_cap` and `realized_cap`.\n`nupl` is calculated as difference between `market_cap` and `realized_cap` divided by `market_cap`.\nIf `market_cap` > `realized_cap`, then `nupl` > 0, which means bitcoin on-chain expected value is less than what they actually have.\nSo this value will give selling pressure.\n`nup` is net unrealized profit, which is calculated as sum of products of UTxO's value and price difference between created and destroyed, divided by `market_cap`.\n`nup` only contains UTxOs in profit.\n`nul` is net unrealized loss. This is opposite indicator of `nup`.\nIt only contains UTxOs in loss.\n","operationId":"getNUPL","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/nupl"}}}}}}
```

## Net Realized Profit and Loss

> Net Realized Profit/Loss metric presenting the net magnitude of profit, or loss realized by all holders spending coins. \
> Realized Profit/Loss is assessed relative to the price when a coin last moved.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"nrpl":{"description":"nrpl","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NRPLResponse"}}}}},"schemas":{"NRPLResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["nrpl"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"nrpl":{"type":"decimal","description":"Net Realized Profit/Loss metric presenting the net magnitude of profit, or loss realized by all holders spending coins."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/nrpl":{"get":{"tags":["BTC Network Indicator"],"summary":"Net Realized Profit and Loss","description":"Net Realized Profit/Loss metric presenting the net magnitude of profit, or loss realized by all holders spending coins. \nRealized Profit/Loss is assessed relative to the price when a coin last moved.\n","operationId":"getNRPL","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/nrpl"}}}}}}
```

## Profit and Loss (UTxO)

> Profit and Loss (UTxO) evaluates the number of UTxOs being in profit or not by comparing the price between created and destroyed.\
> When the price at destroyed time is higher than created, this transaction is in profit.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_d":{"description":"Currently, we only support `day`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"pnl-utxo":{"description":"pnl-utxo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PNLUTxOResponse"}}}}},"schemas":{"PNLUTxOResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_D"},"data":{"type":"array","items":{"type":"object","required":["profit_percent","loss_percent","profit_amount","loss_amount"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"profit_percent":{"type":"decimal","description":"A percent of the number of UTxO in profit among total number of UTxO."},"loss_percent":{"type":"decimal","description":"A percent of the number of UTxO in loss among total number of UTxO."},"profit_amount":{"type":"decimal","description":"The number of UTxO in profit."},"loss_amount":{"type":"decimal","description":"The number of UTxO in loss."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_D":{"type":"string","description":"The size of window. This metric supports only day resolution."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."}}},"paths":{"/btc/network-indicator/pnl-utxo":{"get":{"tags":["BTC Network Indicator"],"summary":"Profit and Loss (UTxO)","description":"Profit and Loss (UTxO) evaluates the number of UTxOs being in profit or not by comparing the price between created and destroyed.\nWhen the price at destroyed time is higher than created, this transaction is in profit.\n","operationId":"getPNLUTxO","parameters":[{"$ref":"#/components/parameters/window_d"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/pnl-utxo"}}}}}}
```

## Profit and Loss (Supply)

> Profit and Loss (Supply) evaluates the sum of UTxOs being in profit or not by comparing the price between created and destroyed.\
> These metrics are similar to the ones in Profit and Loss (UTxO) but differ from putting more weight on each UTxO with its value.\
> Sometimes we want to know the exact alive bitcoin transaction output value in profit. \`pnl-supply\` will show it accuretely.\
> \`pnl-supply\` is calculated as the sum of UTxO value.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"pnl-supply":{"description":"pnl-supply","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PNLSupplyResponse"}}}}},"schemas":{"PNLSupplyResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["profit_percent","loss_percent","profit_amount","loss_amount"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"profit_percent":{"type":"decimal","description":"A percent of the sum of UTxO value in profit among total sum of UTxO value."},"loss_percent":{"type":"decimal","description":"A percent of the sum of UTxO value in loss among total sum of UTxO value."},"profit_amount":{"type":"decimal","description":"The sum of UTxO value in profit."},"loss_amount":{"type":"decimal","description":"The sum of UTxO value in loss."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/pnl-supply":{"get":{"tags":["BTC Network Indicator"],"summary":"Profit and Loss (Supply)","description":"Profit and Loss (Supply) evaluates the sum of UTxOs being in profit or not by comparing the price between created and destroyed.\nThese metrics are similar to the ones in Profit and Loss (UTxO) but differ from putting more weight on each UTxO with its value.\nSometimes we want to know the exact alive bitcoin transaction output value in profit. `pnl-supply` will show it accuretely.\n`pnl-supply` is calculated as the sum of UTxO value.\n","operationId":"getPNLSupply","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/pnl-supply"}}}}}}
```

## Dormancy

> Average Dormancy (\`average\_dormancy\`) is the average number of days destroyed per coin transacted. \
> Supply-Adjusted Average Dormancy (\`sa\_average\_dormancy\`) is the average dormancy normalized by supply total, where supply total increases as more blocks mined.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window":{"description":"Currently we support `day` and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"dormancy":{"description":"The average number of days destroyed per coin transacted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DormancyResponse"}}}}},"schemas":{"DormancyResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window"},"data":{"type":"array","items":{"type":"object","required":["average_dormancy","sa_average_dormancy"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"average_dormancy":{"type":"decimal","description":"The average number of days destroyed per coin transacted."},"sa_average_dormancy":{"type":"decimal","description":"Average dormancy normalized by supply total."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window":{"type":"string","description":"The size of window. It can be day or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/btc/network-indicator/dormancy":{"get":{"tags":["BTC Network Indicator"],"summary":"Dormancy","description":"Average Dormancy (`average_dormancy`) is the average number of days destroyed per coin transacted. \nSupply-Adjusted Average Dormancy (`sa_average_dormancy`) is the average dormancy normalized by supply total, where supply total increases as more blocks mined.\n","operationId":"getDormancy","parameters":[{"$ref":"#/components/parameters/window"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/dormancy"}}}}}}
```

## UTxO Age Distribution

> UTxO Age Distribution is a set of active supply with age bands. This indicator summarizes the behaviors of long-term or short-term holders along with price actions. We provide the distribution values in native, USD, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-age-distribution":{"description":"utxo-age-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxOAgeDistributionResponse"}}}}},"schemas":{"UTxOAgeDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0d_1d","range_1d_1w","range_1w_1m","range_1m_3m","range_3m_6m","range_6m_12m","range_12m_18m","range_18m_2y","range_2y_3y","range_3y_5y","range_5y_7y","range_7y_10y","range_10y_inf","range_0d_1d_usd","range_1d_1w_usd","range_1w_1m_usd","range_1m_3m_usd","range_3m_6m_usd","range_6m_12m_usd","range_12m_18m_usd","range_18m_2y_usd","range_2y_3y_usd","range_3y_5y_usd","range_5y_7y_usd","range_7y_10y_usd","range_10y_inf_usd","range_0d_1d_percent","range_1d_1w_percent","range_1w_1m_percent","range_1m_3m_percent","range_3m_6m_percent","range_6m_12m_percent","range_12m_18m_percent","range_18m_2y_percent","range_2y_3y_percent","range_3y_5y_percent","range_5y_7y_percent","range_7y_10y_percent","range_10y_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0d_1d":{"type":"decimal","description":"Total supply of UTxOs of ages between 0 day to 1 day."},"range_1d_1w":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 day to 1 week."},"range_1w_1m":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 week to 1 month."},"range_1m_3m":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 month to 3 months."},"range_3m_6m":{"type":"decimal","description":"Total supply of UTxOs of ages between 3 months to 6 months."},"range_6m_12m":{"type":"decimal","description":"Total supply of UTxOs of ages between 6 months to 12 months."},"range_12m_18m":{"type":"decimal","description":"Total supply of UTxOs of ages between 12 months to 18 months."},"range_18m_2y":{"type":"decimal","description":"Total supply of UTxOs of ages between 18 months to 2 years."},"range_2y_3y":{"type":"decimal","description":"Total supply of UTxOs of ages between 2 years to 3 years."},"range_3y_5y":{"type":"decimal","description":"Total supply of UTxOs of ages between 3 years to 5 years."},"range_5y_7y":{"type":"decimal","description":"Total supply of UTxOs of ages between 5 years to 7 years."},"range_7y_10y":{"type":"decimal","description":"Total supply of UTxOs of ages between 7 years to 10 years."},"range_10y_inf":{"type":"decimal","description":"Total supply of UTxOs of ages over 10 years."},"range_0d_1d_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 0 day to 1 day in USD."},"range_1d_1w_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 day to 1 week in USD."},"range_1w_1m_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 week to 1 month in USD."},"range_1m_3m_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 1 month to 3 months in USD."},"range_3m_6m_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 3 months to 6 months in USD."},"range_6m_12m_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 6 months to 12 months in USD."},"range_12m_18m_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 12 months to 18 months in USD."},"range_18m_2y_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 18 months to 2 years in USD."},"range_2y_3y_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 2 years to 3 years in USD."},"range_3y_5y_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 3 years to 5 years in USD."},"range_5y_7y_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 5 years to 7 years in USD."},"range_7y_10y_usd":{"type":"decimal","description":"Total supply of UTxOs of ages between 7 years to 10 years in USD."},"range_10y_inf_usd":{"type":"decimal","description":"Total supply of UTxOs of ages over 10 years in USD."},"range_0d_1d_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 0 day to 1 day."},"range_1d_1w_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 1 day to 1 week."},"range_1w_1m_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 1 week to 1 month."},"range_1m_3m_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 1 month to 3 months."},"range_3m_6m_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 3 months to 6 months."},"range_6m_12m_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 6 months to 12 months."},"range_12m_18m_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 12 months to 18 months."},"range_18m_2y_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 18 months to 2 years."},"range_2y_3y_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 2 years to 3 years."},"range_3y_5y_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 3 years to 5 years."},"range_5y_7y_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 5 years to 7 years."},"range_7y_10y_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages between 7 years to 10 years."},"range_10y_inf_percent":{"type":"decimal","description":"Percent supply held by UTxOs of ages over 10 years."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-age-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Age Distribution","description":"UTxO Age Distribution is a set of active supply with age bands. This indicator summarizes the behaviors of long-term or short-term holders along with price actions. We provide the distribution values in native, USD, and percent values.\n","operationId":"getUTxOAgeDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-age-distribution"}}}}}}
```

## UTxO Realized Age Distribution

> UTxO Realized Age Distribution is a set of active supply with age bands weighted by the price at UTxO created time. Similar to Realized Cap, this indicator summarizes the capitalization held by long-term or short-term holders (each band). We provide the distribution values in native, USD, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-realized-age-distribution":{"description":"utxo-realized-age-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxORealizedAgeDistributionResponse"}}}}},"schemas":{"UTxORealizedAgeDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0d_1d_usd","range_1d_1w_usd","range_1w_1m_usd","range_1m_3m_usd","range_3m_6m_usd","range_6m_12m_usd","range_12m_18m_usd","range_18m_2y_usd","range_2y_3y_usd","range_3y_5y_usd","range_5y_7y_usd","range_7y_10y_usd","range_10y_inf_usd","range_0d_1d_percent","range_1d_1w_percent","range_1w_1m_percent","range_1m_3m_percent","range_3m_6m_percent","range_6m_12m_percent","range_12m_18m_percent","range_18m_2y_percent","range_2y_3y_percent","range_3y_5y_percent","range_5y_7y_percent","range_7y_10y_percent","range_10y_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0d_1d_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 0 day to 1 day in USD."},"range_1d_1w_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 1 day to 1 week in USD."},"range_1w_1m_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 1 week to 1 month in USD."},"range_1m_3m_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 1 month to 3 months in USD."},"range_3m_6m_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 3 months to 6 months in USD."},"range_6m_12m_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 6 months to 12 months in USD."},"range_12m_18m_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 12 months to 18 months in USD."},"range_18m_2y_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 18 months to 2 years in USD."},"range_2y_3y_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 2 years to 3 years in USD."},"range_3y_5y_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 3 years to 5 years in USD."},"range_5y_7y_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 5 years to 7 years in USD."},"range_7y_10y_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages between 7 years to 10 years in USD."},"range_10y_inf_usd":{"type":"decimal","description":"Realized supply of UTxOs of ages over 10 years in USD."},"range_0d_1d_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 0 day to 1 day."},"range_1d_1w_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 1 day to 1 week."},"range_1w_1m_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 1 week to 1 month."},"range_1m_3m_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 1 month to 3 months."},"range_3m_6m_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 3 months to 6 months."},"range_6m_12m_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 6 months to 12 months."},"range_12m_18m_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 12 months to 18 months."},"range_18m_2y_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 18 months to 2 years."},"range_2y_3y_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 2 years to 3 years."},"range_3y_5y_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 3 years to 5 years."},"range_5y_7y_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 5 years to 7 years."},"range_7y_10y_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages between 7 years to 10 years."},"range_10y_inf_percent":{"type":"decimal","description":"Percent realized supply held by UTxOs of ages over 10 years."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-realized-age-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Realized Age Distribution","description":"UTxO Realized Age Distribution is a set of active supply with age bands weighted by the price at UTxO created time. Similar to Realized Cap, this indicator summarizes the capitalization held by long-term or short-term holders (each band). We provide the distribution values in native, USD, and percent values.\n","operationId":"getUTxORealizedAgeDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-realized-age-distribution"}}}}}}
```

## UTxO Count Age Distribution

> UTxO Count Age Distribution is a set of active number of holders with age bands. This indicator summarizes how many long-term or short-term holders exist by each band. We provide the distribution values in native, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-count-age-distribution":{"description":"utxo-count-age-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxOCountAgeDistributionResponse"}}}}},"schemas":{"UTxOCountAgeDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0d_1d","range_1d_1w","range_1w_1m","range_1m_3m","range_3m_6m","range_6m_12m","range_12m_18m","range_18m_2y","range_2y_3y","range_3y_5y","range_5y_7y","range_7y_10y","range_10y_inf","range_0d_1d_percent","range_1d_1w_percent","range_1w_1m_percent","range_1m_3m_percent","range_3m_6m_percent","range_6m_12m_percent","range_12m_18m_percent","range_18m_2y_percent","range_2y_3y_percent","range_3y_5y_percent","range_5y_7y_percent","range_7y_10y_percent","range_10y_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0d_1d":{"type":"decimal","description":"Total count of UTxOs of ages between 0 day to 1 day."},"range_1d_1w":{"type":"decimal","description":"Total count of UTxOs of ages between 1 day to 1 week."},"range_1w_1m":{"type":"decimal","description":"Total count of UTxOs of ages between 1 week to 1 month."},"range_1m_3m":{"type":"decimal","description":"Total count of UTxOs of ages between 1 month to 3 months."},"range_3m_6m":{"type":"decimal","description":"Total count of UTxOs of ages between 3 months to 6 months."},"range_6m_12m":{"type":"decimal","description":"Total count of UTxOs of ages between 6 months to 12 months."},"range_12m_18m":{"type":"decimal","description":"Total count of UTxOs of ages between 12 months to 18 months."},"range_18m_2y":{"type":"decimal","description":"Total count of UTxOs of ages between 18 months to 2 years."},"range_2y_3y":{"type":"decimal","description":"Total count of UTxOs of ages between 2 years to 3 years."},"range_3y_5y":{"type":"decimal","description":"Total count of UTxOs of ages between 3 years to 5 years."},"range_5y_7y":{"type":"decimal","description":"Total count of UTxOs of ages between 5 years to 7 years."},"range_7y_10y":{"type":"decimal","description":"Total count of UTxOs of ages between 7 years to 10 years."},"range_10y_inf":{"type":"decimal","description":"Total count of UTxOs of ages over 10 years."},"range_0d_1d_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 0 day to 1 day."},"range_1d_1w_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 1 day to 1 week."},"range_1w_1m_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 1 week to 1 month."},"range_1m_3m_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 1 month to 3 months."},"range_3m_6m_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 3 months to 6 months."},"range_6m_12m_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 6 months to 12 months."},"range_12m_18m_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 12 months to 18 months."},"range_18m_2y_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 18 months to 2 years."},"range_2y_3y_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 2 years to 3 years."},"range_3y_5y_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 3 years to 5 years."},"range_5y_7y_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 5 years to 7 years."},"range_7y_10y_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages between 7 years to 10 years."},"range_10y_inf_percent":{"type":"decimal","description":"Percent count held by UTxOs of ages over 10 years."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-count-age-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Count Age Distribution","description":"UTxO Count Age Distribution is a set of active number of holders with age bands. This indicator summarizes how many long-term or short-term holders exist by each band. We provide the distribution values in native, and percent values.\n","operationId":"getUTxOCountAgeDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-count-age-distribution"}}}}}}
```

## Spent Output Age Distribution

> Spent Output Age Distribution is a set of active sum of spent outputs with age bands. This indicator summarizes how much UTxOs are destroyed by long-term or short-term holders (each band). We provide the distribution values in native, USD, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"spent-output-age-distribution":{"description":"spent-output-age-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpentOutputAgeDistributionResponse"}}}}},"schemas":{"SpentOutputAgeDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0d_1d","range_1d_1w","range_1w_1m","range_1m_3m","range_3m_6m","range_6m_12m","range_12m_18m","range_18m_2y","range_2y_3y","range_3y_5y","range_5y_7y","range_7y_10y","range_10y_inf","range_0d_1d_usd","range_1d_1w_usd","range_1w_1m_usd","range_1m_3m_usd","range_3m_6m_usd","range_6m_12m_usd","range_12m_18m_usd","range_18m_2y_usd","range_2y_3y_usd","range_3y_5y_usd","range_5y_7y_usd","range_7y_10y_usd","range_10y_inf_usd","range_0d_1d_percent","range_1d_1w_percent","range_1w_1m_percent","range_1m_3m_percent","range_3m_6m_percent","range_6m_12m_percent","range_12m_18m_percent","range_18m_2y_percent","range_2y_3y_percent","range_3y_5y_percent","range_5y_7y_percent","range_7y_10y_percent","range_10y_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0d_1d":{"type":"decimal","description":"Total sum of spent outputs of ages between 0 day to 1 day."},"range_1d_1w":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 day to 1 week."},"range_1w_1m":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 week to 1 month."},"range_1m_3m":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 month to 3 months."},"range_3m_6m":{"type":"decimal","description":"Total sum of spent outputs of ages between 3 months to 6 months."},"range_6m_12m":{"type":"decimal","description":"Total sum of spent outputs of ages between 6 months to 12 months."},"range_12m_18m":{"type":"decimal","description":"Total sum of spent outputs of ages between 12 months to 18 months."},"range_18m_2y":{"type":"decimal","description":"Total sum of spent outputs of ages between 18 months to 2 years."},"range_2y_3y":{"type":"decimal","description":"Total sum of spent outputs of ages between 2 years to 3 years."},"range_3y_5y":{"type":"decimal","description":"Total sum of spent outputs of ages between 3 years to 5 years."},"range_5y_7y":{"type":"decimal","description":"Total sum of spent outputs of ages between 5 years to 7 years."},"range_7y_10y":{"type":"decimal","description":"Total sum of spent outputs of ages between 7 years to 10 years."},"range_10y_inf":{"type":"decimal","description":"Total sum of spent outputs of ages over 10 years."},"range_0d_1d_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 0 day to 1 day in USD."},"range_1d_1w_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 day to 1 week in USD."},"range_1w_1m_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 week to 1 month in USD."},"range_1m_3m_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 1 month to 3 months in USD."},"range_3m_6m_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 3 months to 6 months in USD."},"range_6m_12m_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 6 months to 12 months in USD."},"range_12m_18m_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 12 months to 18 months in USD."},"range_18m_2y_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 18 months to 2 years in USD."},"range_2y_3y_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 2 years to 3 years in USD."},"range_3y_5y_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 3 years to 5 years in USD."},"range_5y_7y_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 5 years to 7 years in USD."},"range_7y_10y_usd":{"type":"decimal","description":"Total sum of spent outputs of ages between 7 years to 10 years in USD."},"range_10y_inf_usd":{"type":"decimal","description":"Total sum of spent outputs of ages over 10 years in USD."},"range_0d_1d_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 0 day to 1 day."},"range_1d_1w_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 1 day to 1 week."},"range_1w_1m_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 1 week to 1 month."},"range_1m_3m_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 1 month to 3 months."},"range_3m_6m_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 3 months to 6 months."},"range_6m_12m_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 6 months to 12 months."},"range_12m_18m_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 12 months to 18 months."},"range_18m_2y_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 18 months to 2 years."},"range_2y_3y_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 2 years to 3 years."},"range_3y_5y_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 3 years to 5 years."},"range_5y_7y_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 5 years to 7 years."},"range_7y_10y_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages between 7 years to 10 years."},"range_10y_inf_percent":{"type":"decimal","description":"Percent sum of spent outputs of ages over 10 years."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/spent-output-age-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"Spent Output Age Distribution","description":"Spent Output Age Distribution is a set of active sum of spent outputs with age bands. This indicator summarizes how much UTxOs are destroyed by long-term or short-term holders (each band). We provide the distribution values in native, USD, and percent values.\n","operationId":"getSpentOutputAgeDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/spent-output-age-distribution"}}}}}}
```

## UTxO Supply Distribution

> UTxO Supply Distribution is a set of active supply with balance (supply) bands. This indicator summarizes the behaviors of whales or retails separated by amount of coins they hold along with price actions. We provide the distribution values in native, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-supply-distribution":{"description":"utxo-supply-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxOSupplyDistributionResponse"}}}}},"schemas":{"UTxOSupplyDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0_001","range_001_01","range_01_1","range_1_10","range_10_100","range_100_1k","range_1k_10k","range_10k_inf","range_0_001_percent","range_001_01_percent","range_01_1_percent","range_1_10_percent","range_10_100_percent","range_100_1k_percent","range_1k_10k_percent","range_10k_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0_001":{"type":"decimal","description":"Total supply of UTxOs with balance between 0 and 0.01."},"range_001_01":{"type":"decimal","description":"Total supply of UTxOs with balance between 0.01 and 0.1."},"range_01_1":{"type":"decimal","description":"Total supply of UTxOs with balance between 0.1 and 1."},"range_1_10":{"type":"decimal","description":"Total supply of UTxOs with balance between 1 and 10."},"range_10_100":{"type":"decimal","description":"Total supply of UTxOs with balance between 10 and 100."},"range_100_1k":{"type":"decimal","description":"Total supply of UTxOs with balance between 100 and 1k."},"range_1k_10k":{"type":"decimal","description":"Total supply of UTxOs with balance between 1k and 10k."},"range_10k_inf":{"type":"decimal","description":"Total supply of UTxOs with balance over 10k."},"range_0_001_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 0 and 0.01."},"range_001_01_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 0.01 and 0.1."},"range_01_1_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 0.1 and 1."},"range_1_10_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 1 and 10."},"range_10_100_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 10 and 100."},"range_100_1k_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 100 and 1k."},"range_1k_10k_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between 1k and 10k."},"range_10k_inf_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance over 10k."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-supply-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Supply Distribution","description":"UTxO Supply Distribution is a set of active supply with balance (supply) bands. This indicator summarizes the behaviors of whales or retails separated by amount of coins they hold along with price actions. We provide the distribution values in native, and percent values.\n","operationId":"getUTxOSupplyDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-supply-distribution"}}}}}}
```

## UTxO Realized Supply Distribution

> UTxO Realized Supply Distribution is a set of active supply with balance (supply) bands weighted by the price at UTxO created time. Similar to Realized Cap, this indicator summarizes the capitalization held by whales or retails (each band). We provide the distribution values in USD, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-realized-supply-distribution":{"description":"utxo-realized-supply-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxORealizedSupplyDistributionResponse"}}}}},"schemas":{"UTxORealizedSupplyDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0_1_usd","range_1_10_usd","range_10_100_usd","range_100_1k_usd","range_1k_10k_usd","range_10k_100k_usd","range_100k_1M_usd","range_1M_inf_usd","range_0_1_percent","range_1_10_percent","range_10_100_percent","range_100_1k_percent","range_1k_10k_percent","range_10k_100k_percent","range_100k_1M_percent","range_1M_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0_1_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $0 and $1."},"range_1_10_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $1 and $10."},"range_10_100_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $10 and $100."},"range_100_1k_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $100 and $1k."},"range_1k_10k_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $1k and $10k."},"range_10k_100k_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $10k and $100k."},"range_100k_1M_usd":{"type":"decimal","description":"Total supply of UTxOs with balance between $100k and $1M."},"range_1M_inf_usd":{"type":"decimal","description":"Total supply of UTxOs with balance over $1M."},"range_0_1_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $0 and $1."},"range_1_10_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $1 and $10."},"range_10_100_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $10 and $100."},"range_100_1k_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $100 and $1k."},"range_1k_10k_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $1k and $10k."},"range_10k_100k_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $10k and $100k."},"range_100k_1M_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance between $100k and $1M."},"range_1M_inf_percent":{"type":"decimal","description":"Percent supply held by UTxOs with balance over $1M."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-realized-supply-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Realized Supply Distribution","description":"UTxO Realized Supply Distribution is a set of active supply with balance (supply) bands weighted by the price at UTxO created time. Similar to Realized Cap, this indicator summarizes the capitalization held by whales or retails (each band). We provide the distribution values in USD, and percent values.\n","operationId":"getUTxORealizedSupplyDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-realized-supply-distribution"}}}}}}
```

## UTxO Count Supply Distribution

> UTxO Count Supply Distribution is a set of active number of holders with balance (supply) bands. This indicator summarizes how many whales and retails exist by each band. We provide the distribution values in native, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"utxo-count-supply-distribution":{"description":"utxo-count-supply-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UTxOCountSupplyDistributionResponse"}}}}},"schemas":{"UTxOCountSupplyDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0_001","range_001_01","range_01_1","range_1_10","range_10_100","range_100_1k","range_1k_10k","range_10k_inf","range_0_001_percent","range_001_01_percent","range_01_1_percent","range_1_10_percent","range_10_100_percent","range_100_1k_percent","range_1k_10k_percent","range_10k_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0_001":{"type":"decimal","description":"Total count of UTxOs with balance between 0 and 0.01."},"range_001_01":{"type":"decimal","description":"Total count of UTxOs with balance between 0.01 and 0.1."},"range_01_1":{"type":"decimal","description":"Total count of UTxOs with balance between 0.1 and 1."},"range_1_10":{"type":"decimal","description":"Total count of UTxOs with balance between 1 and 10."},"range_10_100":{"type":"decimal","description":"Total count of UTxOs with balance between 10 and 100."},"range_100_1k":{"type":"decimal","description":"Total count of UTxOs with balance between 100 and 1k."},"range_1k_10k":{"type":"decimal","description":"Total count of UTxOs with balance between 1k and 10k."},"range_10k_inf":{"type":"decimal","description":"Total count of UTxOs with balance over 10k."},"range_0_001_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 0 and 0.01."},"range_001_01_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 0.01 and 0.1."},"range_01_1_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 0.1 and 1."},"range_1_10_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 1 and 10."},"range_10_100_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 10 and 100."},"range_100_1k_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 100 and 1k."},"range_1k_10k_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance between 1k and 10k."},"range_10k_inf_percent":{"type":"decimal","description":"Percent count held by UTxOs with balance over 10k."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/utxo-count-supply-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"UTxO Count Supply Distribution","description":"UTxO Count Supply Distribution is a set of active number of holders with balance (supply) bands. This indicator summarizes how many whales and retails exist by each band. We provide the distribution values in native, and percent values.\n","operationId":"getUTxOCountSupplyDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/utxo-count-supply-distribution"}}}}}}
```

## Spent Output Supply Distribution

> Spent Output Supply Distribution is a set of active sum of spent outputs with balance (supply) bands. This indicator summarizes how much UTxOs are destroyed by whales or retails (each band). We provide the distribution values in native, USD, and percent values.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"BTC Network Indicator","description":"This namespace contains endpoints to retrieve NVT ratio, Stock to Flow ratio, and etc. We provide certain indicators to avoid any risks, assume upside or downside potentials, and give insights on the value of bitcoin. For more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`Authorization` with the `Bearer {access_token}`. Bearer access token is the type of HTTP Authorization.  You have to include access token to the HTTP header and note that leading bearer is required.\nYou must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please [upgrade your plan](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"The maximum number of entries to return before the latest data point (or before `to` if specified). This field ranges from 1 to 100,000.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"spent-output-supply-distribution":{"description":"spent-output-supply-distribution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpentOutputSupplyDistributionResponse"}}}}},"schemas":{"SpentOutputSupplyDistributionResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["range_0_001","range_001_01","range_01_1","range_1_10","range_10_100","range_100_1k","range_1k_10k","range_10k_inf","range_0_1_usd","range_1_10_usd","range_10_100_usd","range_100_1k_usd","range_1k_10k_usd","range_10k_100k_usd","range_100k_1M_usd","range_1M_inf_usd","range_0_001_percent","range_001_01_percent","range_01_1_percent","range_1_10_percent","range_10_100_percent","range_100_1k_percent","range_1k_10k_percent","range_10k_inf_percent"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_H"},"range_0_001":{"type":"decimal","description":"Total sum of spent outputs with balance between 0 and 0.01."},"range_001_01":{"type":"decimal","description":"Total sum of spent outputs with balance between 0.01 and 0.1."},"range_01_1":{"type":"decimal","description":"Total sum of spent outputs with balance between 0.1 and 1."},"range_1_10":{"type":"decimal","description":"Total sum of spent outputs with balance between 1 and 10."},"range_10_100":{"type":"decimal","description":"Total sum of spent outputs with balance between 10 and 100."},"range_100_1k":{"type":"decimal","description":"Total sum of spent outputs with balance between 100 and 1k."},"range_1k_10k":{"type":"decimal","description":"Total sum of spent outputs with balance between 1k and 10k."},"range_10k_inf":{"type":"decimal","description":"Total sum of spent outputs with balance over 10k."},"range_0_1_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $0 and $1."},"range_1_10_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $1 and $10."},"range_10_100_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $10 and $100."},"range_100_1k_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $100 and $1k."},"range_1k_10k_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $1k and $10k."},"range_10k_100k_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $10k and $100k."},"range_100k_1M_usd":{"type":"decimal","description":"Total sum of spent outputs with balance between $100k and $1M."},"range_1M_inf_usd":{"type":"decimal","description":"Total sum of spent outputs with balance over $1M."},"range_0_001_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 0 and 0.01."},"range_001_01_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 0.01 and 0.1."},"range_01_1_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 0.1 and 1."},"range_1_10_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 1 and 10."},"range_10_100_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 10 and 100."},"range_100_1k_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 100 and 1k."},"range_1k_10k_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance between 1k and 10k."},"range_10k_inf_percent":{"type":"decimal","description":"Percent sum of spent outputs with balance over 10k."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_H":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block or window=hour is used."}}},"paths":{"/btc/network-indicator/spent-output-supply-distribution":{"get":{"tags":["BTC Network Indicator"],"summary":"Spent Output Supply Distribution","description":"Spent Output Supply Distribution is a set of active sum of spent outputs with balance (supply) bands. This indicator summarizes how much UTxOs are destroyed by whales or retails (each band). We provide the distribution values in native, USD, and percent values.\n","operationId":"getSpentOutputSupplyDistribution","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/spent-output-supply-distribution"}}}}}}
```