---
title: "UTxO Supply Distribution"
method: GET
path: "/btc/network-indicator/utxo-supply-distribution"
tags: ["BTC Network Indicator"]
---

# UTxO Supply Distribution

`GET /btc/network-indicator/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.


**📖 Data Guide:** [UTXO Value Bands](/data-guide/utxo/utxo-bands-value/utxo-value-bands) — definition, interpretation, and chart examples.

## Query parameters

- `window` string
- `from` string
- `to` string
- `limit` integer
- `format` string

## Response `200`

utxo-supply-distribution

- object
  - `status` object, required — 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.
    - `code` integer, required — HTTP status code
    - `message` string, required — Text description of the error or success.
  - `result` object, required
    - `window` string, required — The size of window. It can be day, hour, or block, and it depends on the user request.
    - `data` object[], required
      - `blockheight` string — The height of the block. This optional field only appears when window=block is used.
      - `date` string — The date in YYYY-DD-MM. This optional field only appears when window=day is used.
      - `datetime` string — 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.
      - `range_0_001` number, required — Total supply of UTxOs with balance between 0 and 0.01.
      - `range_001_01` number, required — Total supply of UTxOs with balance between 0.01 and 0.1.
      - `range_01_1` number, required — Total supply of UTxOs with balance between 0.1 and 1.
      - `range_1_10` number, required — Total supply of UTxOs with balance between 1 and 10.
      - `range_10_100` number, required — Total supply of UTxOs with balance between 10 and 100.
      - `range_100_1k` number, required — Total supply of UTxOs with balance between 100 and 1k.
      - `range_1k_10k` number, required — Total supply of UTxOs with balance between 1k and 10k.
      - `range_10k_inf` number, required — Total supply of UTxOs with balance over 10k.
      - `range_0_001_percent` number, required — Percent supply held by UTxOs with balance between 0 and 0.01.
      - `range_001_01_percent` number, required — Percent supply held by UTxOs with balance between 0.01 and 0.1.
      - `range_01_1_percent` number, required — Percent supply held by UTxOs with balance between 0.1 and 1.
      - `range_1_10_percent` number, required — Percent supply held by UTxOs with balance between 1 and 10.
      - `range_10_100_percent` number, required — Percent supply held by UTxOs with balance between 10 and 100.
      - `range_100_1k_percent` number, required — Percent supply held by UTxOs with balance between 100 and 1k.
      - `range_1k_10k_percent` number, required — Percent supply held by UTxOs with balance between 1k and 10k.
      - `range_10k_inf_percent` number, required — Percent supply held by UTxOs with balance over 10k.

---

[API](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api.md) · [All operations](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cryptoquant/cryptoquant-data-api/versions/81ee223d4908/schema)