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

# UTxO Count Supply Distribution

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


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

## Query parameters

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

## Response `200`

utxo-count-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 count of UTxOs with balance between 0 and 0.01.
      - `range_001_01` number, required — Total count of UTxOs with balance between 0.01 and 0.1.
      - `range_01_1` number, required — Total count of UTxOs with balance between 0.1 and 1.
      - `range_1_10` number, required — Total count of UTxOs with balance between 1 and 10.
      - `range_10_100` number, required — Total count of UTxOs with balance between 10 and 100.
      - `range_100_1k` number, required — Total count of UTxOs with balance between 100 and 1k.
      - `range_1k_10k` number, required — Total count of UTxOs with balance between 1k and 10k.
      - `range_10k_inf` number, required — Total count of UTxOs with balance over 10k.
      - `range_0_001_percent` number, required — Percent count held by UTxOs with balance between 0 and 0.01.
      - `range_001_01_percent` number, required — Percent count held by UTxOs with balance between 0.01 and 0.1.
      - `range_01_1_percent` number, required — Percent count held by UTxOs with balance between 0.1 and 1.
      - `range_1_10_percent` number, required — Percent count held by UTxOs with balance between 1 and 10.
      - `range_10_100_percent` number, required — Percent count held by UTxOs with balance between 10 and 100.
      - `range_100_1k_percent` number, required — Percent count held by UTxOs with balance between 100 and 1k.
      - `range_1k_10k_percent` number, required — Percent count held by UTxOs with balance between 1k and 10k.
      - `range_10k_inf_percent` number, required — Percent count 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)