For the complete documentation index, see llms.txt. This page is also available as Markdown.

Addresses

Accumulation Addresses

get

Definition. The number of unique accumulation addresses. Accumulation addresses are defined as addresses that have at least 2 incoming non-dust transfers and have never spent funds.\n\nTechnical. Exchange addresses and addresses receiving from coinbase transactions (miner addresses) are discarded. To account for lost coins, addresses that were last active more than 7 years ago are omitted as well.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/accumulation_count

Accumulation Balance

get

Definition. The total amount of funds held in accumulation addresses.\n\nTechnical. Accumulation addresses are defined as addresses with at least 2 incoming non-dust transfers that have never spent funds. Exchange addresses and addresses receiving from coinbase transactions (miner addresses) are discarded. To account for lost coins, addresses last active more than 7 years ago are also omitted.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/accumulation_balance

Active Addresses

get

Definition. The number of unique addresses active in the network as a sender or receiver.\n\nTechnical. Only addresses active in successful transactions are counted.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, bnb, eth, opt, sol, ton, trx, xrp. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/active_count

Active Addresses (with contracts)

get

Definition. The number of unique addresses that were active in the network as a sender, a receiver, or by calling a smart contract.\n\nTechnical. Only addresses active in successful transactions are counted.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/active_count_with_contracts

Activity Retention Rate

get

Definition. Activity Retention Rate is the percentage of addresses that were active, through sending or receiving transactions, in the previous 30-day period and remained active in the current one. For example, a 70% retention rate means that 7 out of 10 previously active addresses continued transacting in the following period.\n\nInterpretation. Higher retention reflects sustained user participation and is an indication of the asset's utility, with frequently-used assets such as stablecoins often exhibiting higher rates. A drop in retention may reflect reduced on-chain interaction, though it does not necessarily signal waning interest as users may shift to holding rather than transacting.\n\nNotes. Based on the Activity Retention chart in Glassnode Studio. For more information, see Understanding Retention on Glassnode Insights.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/activity_retention_rate

Address Supply Distribution

get

Definition. Relative Address Supply Distribution reports the share of circulating supply held by addresses falling within each balance band.\n\nTechnical. Every on-chain address is binned by its native-unit balance, and the metric reports the share of total supply controlled by each band.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_distribution_relative

Addresses in Loss

get

Definition. The number of unique addresses whose holdings have an average buy price higher than the current spot price.\n\nTechnical. Buy price is the price at the time coins were transferred into an address.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/loss_count

Addresses in Profit

get

Definition. The number of unique addresses whose funds have an average buy price below the current spot price.\n\nTechnical. "Buy price" is defined as the price at the time coins were transferred into an address.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/profit_count

Addresses with Balance ≥ $1

get

Definition. The number of unique addresses holding at least a value of $1 USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_1_usd_count

Addresses with Balance ≥ $10

get

Definition. The number of unique addresses holding at least a value of $10 USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_10_usd_count

Addresses with Balance ≥ $100

get

Definition. The number of unique addresses holding at least a value of $100 USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_100_usd_count

Addresses with Balance ≥ $100k

get

Definition. The number of unique addresses holding at least a value of $100k USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_100k_usd_count

Addresses with Balance ≥ $10k

get

Definition. The number of unique addresses holding at least a value of $10k USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_10k_usd_count

Addresses with Balance ≥ $1k

get

Definition. The number of unique addresses currently holding at least $1,000 worth of .\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_1k_usd_count

Addresses with Balance ≥ $1M

get

Definition. The number of unique addresses holding at least a value of $1M USD.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_1m_usd_count

Addresses with Balance ≥ 0.01

get

Definition. The number of unique addresses holding at least 0.01 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_point_zero_1_count

Addresses with Balance ≥ 0.1

get

Definition. The number of unique addresses holding at least 0.1 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_point_1_count

Addresses with Balance ≥ 1

get

Definition. The number of unique addresses holding at least 1 coin.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_1_count

Addresses with Balance ≥ 10

get

Definition. The number of unique addresses holding at least 10 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_10_count

Addresses with Balance ≥ 100

get

Definition. The number of unique addresses whose current native-asset balance is at least 100.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_100_count

Addresses with Balance ≥ 10k

get

Definition. The number of unique addresses holding at least 10k coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_10k_count

Addresses with Balance ≥ 1k

get

Definition. The number of unique addresses holding at least 1k coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_1k_count

Addresses with Balance ≥ 32 ETH

get

Definition. Number of unique addresses holding at least 32 ETH. This is the number of potential validators for ETH 2.0.\n\nTechnical. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/min_32_count

Addresses with Non-Zero Balance

get

Definition. The number of unique addresses holding a positive (non-zero) amount of coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/non_zero_count

Depositing Addresses

get

Definition. The number of unique addresses that appeared as a sender in a transaction sending funds to exchanges.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/sending_to_exchanges_count

Holder Accumulation Ratio

get

Definition. Holder Accumulation Ratio is the proportion of active holders who are increasing their positions versus those decreasing them, focusing exclusively on holders who changed their balance. It is calculated by dividing the number of holders who increased their balance by the total number of holders who changed their balance in either direction.\n\nInterpretation. Ratios above 50 ratio means that among holders who adjusted their position, 3 out of 4 chose to accumulate more. Higher ratios may suggest bullish momentum, while lower ratios may indicate distribution or profit-taking.\n\nNotes. Based on the Holder Retention chart in Glassnode Studio. For more information, see Understanding Retention on Glassnode Insights.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/holder_accumulation_ratio

Holder Retention Rate

get

Definition. Holder Retention Rate is the percentage of addresses that maintain a balance of the asset across consecutive 30-day periods. It is calculated by dividing the number of addresses currently holding a balance (including new holders, resurrected holders, and all retained holder categories) by the total number of addresses that held a balance at any point during the observation period.\n\nInterpretation. Higher retention rates reflect stronger holder persistence and long-term commitment. A retention rate of 80% means 8 out of 10 addresses that had a balance continue to hold the asset, while lower rates may indicate selling pressure or loss of confidence.\n\nNotes. Based on the Holder Retention chart in Glassnode Studio. For more information, see Understanding Retention on Glassnode Insights.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/holder_retention_rate

MoM Activity Retention

get

Definition. The number of addresses that interact with the asset, segmented into month-over-month retention cohorts:\n * `New`: addresses that interacted with the asset for the first time during the last 30 days.\n * `Retained (Increase)`: active in both the previous and current 30d period, with rising activity.\n * `Retained (Equal)`: active in both periods with the same activity.\n * `Retained (Decrease)`: active in both periods with reduced activity.\n * `Resurrected`: active in the current but inactive in the previous 30d period.\n * `Churned`: inactive in the last 30 days but active in the previous 30d period.\n * `Dead` (API only): inactive in the current and previous 30d interval but active at some point before.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/activity_retention

MoM Holder Retention

get

Definition. The number of addresses currently or previously holding , segmented into month-over-month retention cohorts:\n * `New`: addresses that interacted with the asset for the first time during the last 30 days and have a non-zero balance.\n * `Retained (Increase)`: addresses that had a non-zero balance 30d ago and have increased their holdings since then.\n * `Retained (Equal)`: addresses that have the same non-zero balance now compared to 30 days ago.\n * `Retained (Decrease)`: addresses that had a non-zero balance 30d ago and have reduced their holdings since then, but still have a balance greater than zero.\n * `Resurrected`: addresses with a non-zero balance that didn't hold any supply 30 days ago. Addresses that appeared for the first time during the last 30 days are not included here and instead captured in the `New` cohort.\n * `Churned`: addresses that no longer hold any supply, but had a non-zero balance 30 days ago.\n * `Resurrected & Churned`: addresses that neither hold any supply nor held supply 30d ago, but had a non-zero balance in between. Addresses that appeared for the first time during the last 30 days are not included here and instead captured in the `New & Churned` cohort.\n * `New & Churned`: addresses that interacted with the asset for the first time during the last 30 days, but no longer hold any supply.\n * `Dead` (API only): addresses that didn't hold any supply during the last 30 days, but had a non-zero balance at some point before.\n\nTechnical. Addresses with a balance below a certain dust threshold are not considered as holders.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/holder_retention

New Addresses

get

Definition. The number of unique addresses that appeared for the first time in a transaction of the native coin in the network.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/new_non_zero_count

Percent Addresses in Profit

get

Definition. The percentage of unique addresses whose funds have an average buy price below the current price.\n\nTechnical. "Buy price" is defined as the price at the time coins were transferred into an address.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/profit_relative

Receiving Addresses

get

Definition. The number of unique addresses that were active as a receiver of funds.\n\nTechnical. Only addresses active as a receiver in successful non-zero transfers are counted.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, bnb, eth, opt, sol, ton, trx, xrp. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/receiving_count

Sending Addresses

get

Definition. The number of unique addresses that were active as a sender of funds.\n\nTechnical. Only addresses active as a sender in successful non-zero transfers are counted.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, bnb, eth, opt, sol, ton, trx, xrp. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/sending_count

Supply Held by Addresses with Balance < 0.001

get

Definition. The total circulating supply held by addresses with a native-asset balance below 0.001 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_less_0001

Supply Held by Addresses with Balance > 100k

get

Definition. The total circulating supply held by addresses with a balance of at least 100,000 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_more_100k

Supply Held by Addresses with Balance 0.001 - 0.01

get

Definition. The total circulating supply held by addresses with a balance between 0.001 and 0.01 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_0001_001

Supply Held by Addresses with Balance 0.01 - 0.1

get

Definition. The total circulating supply held by addresses with a balance between 0.01 and 0.1 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_001_01

Supply Held by Addresses with Balance 0.1 - 1

get

Definition. The total circulating supply held by addresses with a balance between 0.1 and 1 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_01_1

Supply Held by Addresses with Balance 1 - 10

get

Definition. The total circulating supply held by addresses with a balance between 1 and 10 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_1_10

Supply Held by Addresses with Balance 10 - 100

get

Definition. The total circulating supply held by addresses with a balance between 10 and 100 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_10_100

Supply Held by Addresses with Balance 100 - 1k

get

Definition. The total circulating supply held by addresses with a balance between 100 and 1,000 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_100_1k

Supply Held by Addresses with Balance 10k - 100k

get

Definition. The total circulating supply held by addresses with a balance between 10,000 and 100,000 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_10k_100k

Supply Held by Addresses with Balance 1k - 10k

get

Definition. The total circulating supply held by addresses with a balance between 1,000 and 10,000 coins.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_1k_10k

Supply in Addresses Holding above 10000 ppm

get

Definition. The total circulating supply held by addresses with a balance above 10000 parts per million of the total supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_above_10000_ppm

Supply in Addresses Holding between 0.01 and 10 ppm

get

Definition. The total circulating supply held by addresses with a balance between 0.01 and 10 parts per million of the total supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_01_10_ppm

Supply in Addresses Holding between 10 and 1000 ppm

get

Definition. The total circulating supply held by addresses with a balance between 10 and 1000 parts per million of the total supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_10_1000_ppm

Supply in Addresses Holding between 1000 and 10000 ppm

get

Definition. The total circulating supply held by addresses with a balance between 1000 and 10000 parts per million of the total supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_1000_10000_ppm

Supply in Addresses Holding less than 0.01 ppm

get

Definition. The total circulating supply held by addresses with a balance below 0.01 parts per million of the total supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, eth, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/supply_balance_less_01_ppm

Total Addresses

get

Definition. The total number of unique addresses that ever appeared in a transaction of the native coin in the network.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/count

Withdrawing Addresses

get

Definition. The number of unique addresses that appeared as a receiver in a transaction receiving funds from an exchange.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/addresses/receiving_from_exchanges_count

Last updated