Addresses

Accumulation Addresses

GET https://api.glassnode.com/v1/metrics/addresses/accumulation_count

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. 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.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":784404}]

400 Bad Request

unsupported asset

Accumulation Balance

GET https://api.glassnode.com/v1/metrics/addresses/accumulation_balance

The total amount of funds held in accumulation addresses. Accumulation addresses are defined as addresses that have at least 2 incoming non-dust transfers and have never spent funds. 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.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":2969676.22204852}]

400 Bad Request

unsupported asset

Active Addresses

GET https://api.glassnode.com/v1/metrics/addresses/active_count

The number of unique addresses that were active in the network either as a sender or receiver. Only addresses that were active in successful transactions are counted.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":1087113}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Address Supply Distribution

GET https://api.glassnode.com/v1/metrics/addresses/supply_distribution_relative

The relative distribution of the circulating supply held by addresses with specific balance bands.

ETH: The relative supply distribution across addresses with specific balance bands. Only supply in Externally Owned Addresses (EOAs) is included, supply in contracts is excluded. Therefore the numbers are relative to the total supply held in EOAs.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":0.0020153668000155306,"001_01":0.012785040392795021,"01_1":0.05248008722052417,"100_1k":0.20227556564233962,"10_100":0.22905303860331783,"10k_100k":0.12528536629526624,"1_10":0.1071276899872429,"1k_10k":0.234404416794501,"above_100k":0.03433713071787494,"less_0001":0.00023629754612249033}}]

400 Bad Request

unsupported asset

Addresses in Loss

GET https://api.glassnode.com/v1/metrics/addresses/loss_count

The number of unique addresses whose funds have an average buy price that is higher than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address.

ETH: The number of unique addresses whose funds have an average buy price that is higher than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address. Only Externally Owned Addresses (EOAs) is are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":15889716}]

400 Bad Request

unsupported asset

Addresses in Profit

GET https://api.glassnode.com/v1/metrics/addresses/profit_count

The number of unique addresses whose funds have an average buy price that is lower than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address.

ETH: The number of unique addresses whose funds have an average buy price that is lower than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address. Only Externally Owned Addresses (EOAs) is are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":28372490}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $1

GET https://api.glassnode.com/v1/metrics/addresses/min_1_usd_count

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

ETH: The number of unique addresses holding at least a value of $1 USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":36462765}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $10

GET https://api.glassnode.com/v1/metrics/addresses/min_10_usd_count

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

ETH: The number of unique addresses holding at least a value of $10 USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":25830997}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $100

GET https://api.glassnode.com/v1/metrics/addresses/min_100_usd_count

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

ETH: The number of unique addresses holding at least a value of $100 USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":14978095}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $100k

GET https://api.glassnode.com/v1/metrics/addresses/min_100k_usd_count

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

ETH: The number of unique addresses holding at least a value of $100k USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":278288}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $10k

GET https://api.glassnode.com/v1/metrics/addresses/min_10k_usd_count

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

ETH: The number of unique addresses holding at least a value of $10k USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":1741764}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $1k

GET https://api.glassnode.com/v1/metrics/addresses/min_1k_usd_count

The number of unique addresses holding at least a value of $1k USD.

ETH: The number of unique addresses holding at least a value of $1k USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":6245115}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ $1M

GET https://api.glassnode.com/v1/metrics/addresses/min_1m_usd_count

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

ETH: The number of unique addresses holding at least a value of $1M USD. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":66726}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 0.01

GET https://api.glassnode.com/v1/metrics/addresses/min_point_zero_1_count

The number of unique addresses holding at least 0.01 coins.

ETH: The number of unique addresses holding at least 0.01 coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":11574343}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 0.1

GET https://api.glassnode.com/v1/metrics/addresses/min_point_1_count

The number of unique addresses holding at least 0.1 coins.

ETH: The number of unique addresses holding at least 0.1 coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":4244697}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 1

GET https://api.glassnode.com/v1/metrics/addresses/min_1_count

The number of unique addresses holding at least 1 coin.

ETH: The number of unique addresses holding at least 1 coin. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":983292}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 10

GET https://api.glassnode.com/v1/metrics/addresses/min_10_count

The number of unique addresses holding at least 10 coins.

ETH: The number of unique addresses holding at least 10 coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":155520}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 100

GET https://api.glassnode.com/v1/metrics/addresses/min_100_count

The number of unique addresses holding at least 100 coins.

ETH: The number of unique addresses holding at least 100 coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":16044}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 10k

GET https://api.glassnode.com/v1/metrics/addresses/min_10k_count

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

ETH: The number of unique addresses holding at least 10k coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":118}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 1k

GET https://api.glassnode.com/v1/metrics/addresses/min_1k_count

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

ETH: The number of unique addresses holding at least 1k coins. Only Externally Owned Addresses (EOAs) are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":2002}]

400 Bad Request

unsupported asset

Addresses with Balance ≥ 32 ETH

GET https://api.glassnode.com/v1/metrics/addresses/min_32_count

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

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":129430}]

400 Bad Request

unsupported asset

Addresses with Non-Zero Balance

GET https://api.glassnode.com/v1/metrics/addresses/non_zero_count

The number of unique addresses holding a positive (non-zero) amount of coins. Note that ERC-20 Assets 1h resolution is being updated every 24 hours.

ETH: The number of unique addresses holding a positive (non-zero) amount of coins. Contracts are excluded, only Externally Owned Addresses (EOAs) are counted. Note that ERC-20 Assets 1h resolution is being updated every 24 hours.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":44268536}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Depositing Addresses

GET https://api.glassnode.com/v1/metrics/addresses/sending_to_exchanges_count

The number of unique addresses that appeared as a sender in a transaction sending funds to exchanges.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 1h, 24h, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":111414}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

New Addresses

GET https://api.glassnode.com/v1/metrics/addresses/new_non_zero_count

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

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":543019}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Percent Addresses in Profit

GET https://api.glassnode.com/v1/metrics/addresses/profit_relative

The percentage of unique addresses whose funds have an average buy price that is lower than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address.

ETH: The percentage of unique addresses whose funds have an average buy price that is lower than the current price. "Buy price" is here defined as the price at the time coins were transferred into an address. Only Externally Owned Addresses (EOAs) is are counted, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":0.6409252965357787}]

400 Bad Request

unsupported asset

Receiving Addresses

GET https://api.glassnode.com/v1/metrics/addresses/receiving_count

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

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":807610}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Sending Addresses

GET https://api.glassnode.com/v1/metrics/addresses/sending_count

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

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":681895}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Supply Held by Addresses with Balance < 0.001

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_less_0001

The total circulating supply held by addresses with balance lower than 0.001 coins.

ETH: The total supply held by addresses with balance lower than 0.001 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":4564.665894219999}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance > 100k

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_more_100k

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

ETH: The total supply held by addresses with balance of at least 100,000 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":663305.7857147999}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 0.001 - 0.01

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_0001_001

The total circulating supply held by addresses with balance between 0.001 and 0.01 coins.

ETH: The total supply held by addresses with balance between 0.001 and 0.01 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":38931.74621291}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 0.01 - 0.1

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_001_01

The total circulating supply held by addresses with balance between 0.01 and 0.1 coins.

ETH: The total supply held by addresses with balance between 0.01 and 0.1 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":246974.37106251}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 0.1 - 1

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_01_1

The total circulating supply held by addresses with balance between 0.1 and 1 coins.

ETH: The total supply held by addresses with balance between 0.1 and 1 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":1013781.43020173}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 1 - 10

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_1_10

The total circulating supply held by addresses with balance between 1 and 10 coins.

ETH: The total supply held by addresses with balance between 1 and 10 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":2069433.73232431}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 10 - 100

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_10_100

The total circulating supply held by addresses with balance between 10 and 100 coins.

ETH: The total supply held by addresses with balance between 10 and 100 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":4424720.48667842}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 100 - 1k

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_100_1k

The total circulating supply held by addresses with balance between 100 and 1k coins.

ETH: The total supply held by addresses with balance between 100 and 1,000 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":3907448.007280709}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 10k - 100k

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_10k_100k

The total circulating supply held by addresses with balance between 10k and 100k coins.

ETH: The total supply held by addresses with balance between 10,000 and 100,000 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":2420193.72590696}]

400 Bad Request

unsupported asset

Supply Held by Addresses with Balance 1k - 10k

GET https://api.glassnode.com/v1/metrics/addresses/supply_balance_1k_10k

The total circulating supply held by addresses with balance between 1k and 10k coins.

ETH: The total supply held by addresses with balance between 1,000 and 10,000 coins. Only supply in Externally Owned Addresses (EOAs) is included, contracts are excluded.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":4528095.46418963}]

400 Bad Request

unsupported asset

Total Addresses

GET https://api.glassnode.com/v1/metrics/addresses/count

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

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 24h, 10m, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":1098460013}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Withdrawing Addresses

GET https://api.glassnode.com/v1/metrics/addresses/receiving_from_exchanges_count

The number of unique addresses that appeared as a receiver in a transaction receiving funds from an exchanges.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol (see list below for more details)
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 1h, 24h, 1w, 1month
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"v":59179}]

400 Bad Request

unsupported asset

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX