Supply
Adjusted Supply
GET
https://api.glassnode.com/v1/metrics/supply/current_adjusted
The circulating supply adjusted by accounting for lost coins. The amount of lost coins is estimated by all those that have not moved in over 7 years.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Asia Year-over-Year Supply Change
GET
https://api.glassnode.com/v1/metrics/supply/apac_1y_supply_change
This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in Asia.
Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:
US: 8am to 8pm Eastern Time (13:00-01:00 UTC)
EU: 8am to 8pm Central European Time (07:00-19:00 UTC)
Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)
An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.
Query Parameters
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)
Burn Rate (Base Fee)
GET
https://api.glassnode.com/v1/metrics/supply/burn_rate
This metric represents the ongoing pace at which ETH is being burned, following the introduction of the London Hard Fork and the implementation of EIP-1559. The Ethereum Improvement Proposal (EIP-1559) established a base fee for each transaction, which is subsequently incinerated, reducing the overall ETH supply. By tracking the ETH burn rate, users can gain insights into the deflationary pressure on Ethereum and its potential impact on the network's long-term economic dynamics.
Query Parameters
a*
string
asset symbol: ETH
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 10m, 1h, 24h, 1w, 1month
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Burned Supply
GET
https://api.glassnode.com/v1/metrics/supply/burned
This metric represents the cumulative sum of ETH incinerated since the implementation of the London Hard Fork, which introduced EIP-1559. The Ethereum Improvement Proposal (EIP-1559) established a base fee for transactions, which is burned to reduce the overall ETH supply. As a result, this metric indicates the deflationary pressure on Ethereum.
Query Parameters
a*
string
asset symbol: ETH
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 10m, 1h, 24h, 1w, 1month
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Circulating Supply
GET
https://api.glassnode.com/v1/metrics/supply/current
The total amount of all coins ever created/issued, i.e. the circulating supply.
ETH: The total amount of coins created or issued - the total amount of coins burned. This includes issuance via the Beacon chain since Beacon Chain genesis and ETH burned since the London upgrade (EIP-1559).
Query Parameters
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
c
string
currency: USD, NATIVE
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, ACH, ACX, ADP, ADS, AE, AGIX, AGLD, AGRS, AHT, AIAT, AIOZ, AIPAD, AIT, ALCX, ALD, ALEPH, ALI, ALICE, ALKI, ALPH, ALPHA, AMB, AMO, AMP, AMPL, ANGLE, ANKR, ANT, APE, APEX, APFC, API3, APRS, AQT, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, AUCTION, AUDIO, AURORA, AVA, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAL, BAND, BAT, BAX, BEAMMW, BEL, BEPRO, BETA, BFC, BGB, BICO, BIGTIME, BITRUE, BKN, BLENDR, BLUR, BMEX, BMX, BNT, BOA, BOBA, BOBT, BOND, BONE, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BTM, BUSD, BXX, BZR, BZRX, C98, CAGA, CAH, CAKE, CANTO, CAPS, CAST, CAW, CBETH, CBK, CBY, CEEK, CEL, CELL, CELR, CERE, CET, CGPT, CHEQ, CHESS, CHEX, CHR, CHRP, CHZ, CLV, COMAI, COMBO, COMP, COPI, CORGIAI, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CVC, CVP, CVX, CVXCRV, CWEB, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DF, DFI, DHT, DIA, DIONE, DKA, DMAIL, DMTR, DNT, DODO, DOGENFT, DOLA, DOMI, DOSE, DPI, DRGN, DUSK, DUST, ECOX, EDEN, EDU, EFI, EJS, EL, ELA, ELF, ELON, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ETHDYDX, ETHFI, EUL, EURS, EURT, FARM, FCT, FDUSD, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLX, FOOM, FOR, FORT, FOX, FRAX, FRM, FRONT, FTM, FTT, FUN, FUSE, FX, FXS, GAL, GALA, GEEQ, GELATO, GEOJ, GFI, GHST, GLM, GMM, GMTT, GNO, GODS, GOG, GPU, GRT, GT, GUSD, HAI, HARRYP, HEART, HEGIC, HELLO, HEMULE, HEZ, HFT, HOPR, HOT, HT, HVH, IAG, ICHI, ID, IDEX, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INV, IOTX, IPOR, IQ, ISKR, ISP, JOECOIN, JPEG, KAI, KARATE, KATA, KCS, KEEP, KEY, KISHU, KNDX, KOMPETE, KP3R, KRL, LADYS, LAI, LAMB, LBA, LDO, LEO, LEVER, LINA, LINK, LIT, LITH, LM, LMWR, LOKA, LON, LOOKS, LOOM, LPT, LQTY, LRC, LSETH, LSK, LSS, LUNC, LYXE, MAGIC, MAHA, MAN, MANA, MANTLE, MAP, MARSH, MATH, MATIC, MAVIA, MBL, MC, MCADE, MCB, MCRT, META, METH, METIS, MFT, MIN, MIR, MIX, MKR, MLN, MLT, MMX, MOC, MOG, MPL, MTA, MTD, MTL, MTLX, MUBI, MUSE, MUSIC, MVL, MX, MXC, MYRIA, MYTH, NAVI, NCT, NDX, NEAR, NEST, NEXO, NFT, NFTX, NIZA, NKN, NMR, NOIA, NRG, NSURE, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OGN, OGV, OHMV2, OKB, OLAS, OM, OMG, OMI, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OVR, OX, OXT, OXY, PAAL, PANDORA, PARI, PAW, PAY, PDA, PEAS, PEOPLE, PEPE, PEPE2, PEPECOIN, PERP, PHA, PIB, PICKLE, PKF, PLU, PNK, PNT, POL, POLA, POLS, POLY, POND, POOH, PORK, PORT3, POWR, PPT, PRE, PRIME, PRNT, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUNDIX, PUSH, PYR, PYUSD, QASH, QKC, QNT, QORPO, QTCON, RACA, RAD, RADAR, RAI, RAIL, RARE, RARI, RBN, RBX, RDN, RDNT, REEF, REN, REP, REQ, RETH, REVV, REZ, RING, RLB, RLC, RMRK, ROOK, ROUTE, RPL, RSC, RSR, RSS3, RUNE, RVF, SAITA, SAITO, SAMA, SAND, SAVM, SD, SDAO, SDEX, SEAM, SENATE, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHRAP, SHX, SIDESHIFT, SIDUS, SILO, SIS, SKEB, SKEY, SKL, SLN, SMURFCATETH, SNC, SNT, SNX, SOFI, SOLVE, SOMNIUM, SORA, SOV, SPA, SPOOL, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STG, STMX, STORJ, STOS, STPT, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWFTC, SXP, SYLO, SYN, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKX, TLM, TLOS, TOKE, TOMI, TORN, TOWER, TPT, TRAC, TRIBE, TRUF, TRUMP, TRVL, TRX, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UNCX, UNFI, UNI, UNIBOT, UOS, UQC, USDC, USDD, USDE, USDP, USDT, USDY, USTC, UTK, UX, VALOR, VEGA, VERI, VEXT, VGX, VIB, VIDT, VIRTUAL, VIX, VMINT, VNM, VR, VRA, VVS, VXV, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WETH, WHALE, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WRX, WSM, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XOR, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZIG, ZKML, ZRX
EU Year-over-Year Supply Change
GET
https://api.glassnode.com/v1/metrics/supply/emea_1y_supply_change
This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in Europe.
Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:
US: 8am to 8pm Eastern Time (13:00-01:00 UTC)
EU: 8am to 8pm Central European Time (07:00-19:00 UTC)
Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)
An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.
Query Parameters
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)
Highly Liquid Supply
GET
https://api.glassnode.com/v1/metrics/supply/highly_liquid_sum
The total supply held by "highly liquid" entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is Ⲡ0.25 / 0.25 ⲠL Ⲡ0.75 / 0.75 ⲠL, respectively. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
HODL Waves
GET
https://api.glassnode.com/v1/metrics/supply/hodl_waves
Bundle of all active supply age bands, aka HODL waves. Each colored band shows the percentage of in existence that was last moved within the time period denoted in the legend. The concept of HODL waves was first described in this post by Unchained Capital.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
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)
Illiquid Supply
GET
https://api.glassnode.com/v1/metrics/supply/illiquid_sum
The total supply held by illiquid entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is Ⲡ0.25 / 0.25 ⲠL Ⲡ0.75 / 0.75 ⲠL, respectively. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Illiquid Supply Change
GET
https://api.glassnode.com/v1/metrics/supply/illiquid_change
The monthly (30d) net change of supply held by illiquid entities. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Inflation Rate
GET
https://api.glassnode.com/v1/metrics/supply/inflation_rate
The percentage of new coins issued, divided by the current supply.
ETH: The net supply change (issuance - burn) divided by the current supply.
Query Parameters
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)
Issuance
GET
https://api.glassnode.com/v1/metrics/supply/issued
The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network.
ETH: The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network. Beacon Chain issuance since the genesis on 2020-12-01 is included. This is computed as (Base Reward Factor * Max Balance at Stake / sqrt(Max Balance at Stake)) per epoch on the Beacon Chain.
Query Parameters
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: USD, NATIVE
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Liquid and Illiquid Supply
GET
https://api.glassnode.com/v1/metrics/supply/liquid_illiquid_sum
The total supply held by illiquid, liquid, and highly liquid entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is Ⲡ0.25 / 0.25 ⲠL Ⲡ0.75 / 0.75 ⲠL, respectively. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Liquid Supply
GET
https://api.glassnode.com/v1/metrics/supply/liquid_sum
The total supply held by "liquid" entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is Ⲡ0.25 / 0.25 ⲠL Ⲡ0.75 / 0.75 ⲠL, respectively. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Liquid Supply Change
GET
https://api.glassnode.com/v1/metrics/supply/liquid_change
The monthly (30d) net change of supply held by liquid and highly liquid entities. For more information see our introductory article on Bitcoin liquidity.
Query Parameters
a*
string
asset symbol: BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 24h, 1h, 10m
f
string
format: JSON, CSV
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Long-Term Holder Position Change
GET
https://api.glassnode.com/v1/metrics/supply/lth_net_change
The monthly net position change of long term holders, i.e. the 30 day change in supply held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Long-Term Holder Supply
GET
https://api.glassnode.com/v1/metrics/supply/lth_sum
The total amount of circulating supply held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Long-Term Holder Supply in Loss
GET
https://api.glassnode.com/v1/metrics/supply/lth_loss_sum
The total amount of circulating supply that is currently at loss and held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Long-Term Holder Supply in Profit
GET
https://api.glassnode.com/v1/metrics/supply/lth_profit_sum
The total amount of circulating supply that is currently in profit and held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Minted Supply
GET
https://api.glassnode.com/v1/metrics/supply/minted
The total amount of issued ETH.
Query Parameters
a*
string
asset symbol: ETH
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 10m, 1h, 24h, 1w, 1month
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Percent Supply in Profit
GET
https://api.glassnode.com/v1/metrics/supply/profit_relative
The percentage of circulating supply in profit, i.e. the percentage of existing coins whose price at the time they last moved was lower than the current price. For more information see this article.
Query Parameters
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)
Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, ACH, ACX, ADP, ADS, AE, AGIX, AGLD, AGRS, AHT, AIAT, AIOZ, AIPAD, AIT, ALCX, ALD, ALEPH, ALI, ALICE, ALKI, ALPH, ALPHA, AMB, AMO, AMP, AMPL, ANGLE, ANKR, ANT, APE, APEX, APFC, API3, APRS, AQT, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, AUCTION, AUDIO, AURORA, AVA, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAL, BAND, BAT, BAX, BEAMMW, BEL, BEPRO, BETA, BFC, BGB, BICO, BIGTIME, BITRUE, BKN, BLENDR, BLUR, BMEX, BMX, BNT, BOA, BOBA, BOBT, BOND, BONE, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BTM, BUSD, BXX, BZR, BZRX, C98, CAGA, CAH, CAKE, CANTO, CAPS, CAST, CAW, CBETH, CBK, CBY, CEEK, CEL, CELL, CELR, CERE, CET, CGPT, CHEQ, CHESS, CHEX, CHR, CHRP, CHZ, CLV, COMAI, COMBO, COMP, COPI, CORGIAI, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CVC, CVP, CVX, CVXCRV, CWEB, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DF, DFI, DHT, DIA, DIONE, DKA, DMAIL, DMTR, DNT, DODO, DOGENFT, DOLA, DOMI, DOSE, DPI, DRGN, DUSK, DUST, ECOX, EDEN, EDU, EFI, EJS, EL, ELA, ELF, ELON, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ETHFI, EUL, EURS, EURT, FARM, FCT, FDUSD, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLX, FOOM, FOR, FORT, FOX, FRAX, FRM, FRONT, FTM, FTT, FUN, FUSE, FX, FXS, GAL, GALA, GEEQ, GELATO, GEOJ, GFI, GHST, GLM, GMM, GMTT, GNO, GODS, GOG, GPU, GRT, GT, GUSD, HAI, HARRYP, HEART, HEGIC, HELLO, HEMULE, HEZ, HFT, HOPR, HOT, HT, HVH, IAG, ICHI, ID, IDEX, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INV, IOTX, IPOR, IQ, ISKR, ISP, JOECOIN, JPEG, KAI, KARATE, KATA, KCS, KEEP, KEY, KISHU, KNDX, KOMPETE, KP3R, KRL, LADYS, LAI, LAMB, LBA, LDO, LEO, LEVER, LINA, LINK, LIT, LITH, LM, LMWR, LOKA, LON, LOOKS, LPT, LQTY, LRC, LSETH, LSK, LSS, LUNC, LYXE, MAGIC, MAHA, MAN, MANA, MANTLE, MAP, MARSH, MATH, MATIC, MAVIA, MBL, MC, MCADE, MCB, MCRT, META, METH, METIS, MFT, MIN, MIR, MIX, MKR, MLN, MLT, MMX, MOC, MOG, MPL, MTA, MTD, MTL, MTLX, MUBI, MUSE, MUSIC, MVL, MX, MXC, MYRIA, MYTH, NAVI, NCT, NDX, NEAR, NEST, NEXO, NFT, NFTX, NIZA, NKN, NMR, NOIA, NRG, NSURE, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OGN, OGV, OHMV2, OKB, OLAS, OM, OMG, OMI, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OVR, OX, OXT, OXY, PAAL, PANDORA, PARI, PAW, PAY, PDA, PEAS, PEOPLE, PEPE, PEPE2, PEPECOIN, PERP, PHA, PIB, PICKLE, PKF, PLU, PNK, PNT, POL, POLA, POLS, POLY, POND, POOH, PORK, PORT3, POWR, PPT, PRE, PRIME, PRNT, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUNDIX, PUSH, PYR, PYUSD, QASH, QKC, QNT, QORPO, QTCON, RACA, RAD, RADAR, RAI, RAIL, RARE, RARI, RBN, RBX, RDN, RDNT, REEF, REN, REP, REQ, RETH, REVV, REZ, RING, RLB, RLC, RMRK, ROOK, ROUTE, RPL, RSC, RSR, RSS3, RUNE, RVF, SAITA, SAITO, SAMA, SAND, SAVM, SD, SDAO, SDEX, SEAM, SENATE, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHRAP, SHX, SIDESHIFT, SIDUS, SILO, SIS, SKEB, SKEY, SKL, SLN, SMURFCATETH, SNC, SNT, SNX, SOFI, SOLVE, SOMNIUM, SORA, SOV, SPA, SPOOL, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STG, STMX, STORJ, STOS, STPT, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWFTC, SXP, SYLO, SYN, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKX, TLM, TLOS, TOKE, TOMI, TORN, TOWER, TPT, TRAC, TRIBE, TRUF, TRUMP, TRVL, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UNCX, UNFI, UNI, UNIBOT, UOS, UQC, USDC, USDD, USDE, USDP, USDT, USDY, USTC, UTK, UX, VALOR, VEGA, VERI, VEXT, VGX, VIB, VIDT, VIRTUAL, VIX, VMINT, VNM, VR, VRA, VVS, VXV, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WETH, WHALE, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WRX, WSM, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XOR, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZIG, ZKML, ZRX
Probably Lost Supply
GET
https://api.glassnode.com/v1/metrics/supply/probably_lost
Probably lost coins refer to so-called "zombie coins". Zombie coins are coins that have been inactive since the launch of the first BTC exchange in July 2010. Zombie coins are probably lost, as there is a non-zero probability that they can still be spent. Note that over time the chart steadily decreases as coins from before July 2010 are spent, eventually converging to the real number of lost coins. "Patoshi" coins are included in this category.
Query Parameters
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)
Provably Lost Supply
GET
https://api.glassnode.com/v1/metrics/supply/provably_lost
The total amount of BTC that is provably lost. Provably lost coins fall into one of the following categories:
Unclaimed miner rewards: The Bitcoin protocol states that the miner of a valid block can add a special transaction to claim a reward plus the transaction fees. Miners are not allowed to claim more than the specified reward, but they are allowed to claim less.
BTC sent to burn addresses: We identify a burn address as an address whose private key has provably no owner. We consider addresses which are virtually impossible to be randomly generated, for example: '1Anything11111111111111111125qfuN'
BTC sent to 'OP_RETURN': OP_RETURN is a script opcode that has been primarily used as a means of storing data on the blockchain. Coins sent to OP_RETURN opcode are provably unspendable as they do not get added to the UTXO set.
Query Parameters
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)
Realized Cap by Date Bands
GET
https://api.glassnode.com/v1/metrics/supply/rcap_by_date_bands
This metric shows a breakdown of the Realized Cap by date bands. Each date band refers to the date when the UTXO was created. The metric is similar to the concept of Realized Cap HODL Waves, however it uses absolute date ranges instead of floating time periods.
Query Parameters
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)
Realized Cap HODL Waves
GET
https://api.glassnode.com/v1/metrics/supply/rcap_hodl_waves
HODL Waves weighted by Realized Price. The idea for this visualization of HODL waves was first introduced by @typerbole.
Query Parameters
a*
string
asset symbol: BTC, BNB, SOL, TRX
network
string
Asset Dependent. ETH values: eth, arb, aggregated
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)
Relative Long/Short-Term Holder Supply
GET
https://api.glassnode.com/v1/metrics/supply/lth_sth_profit_loss_relative
The relative amount of circulating supply of held by long- and short-term holders in profit/loss. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Relative Realized Cap by Date Bands
GET
https://api.glassnode.com/v1/metrics/supply/rcap_by_date_bands_relative
This metric shows a breakdown of the relative Realized Cap by date bands. Each date band refers to the date when the UTXO was created. The metric is similar to the concept of Realized Cap HODL Waves, however it uses absolute date ranges instead of floating time periods.
Query Parameters
a*
string
asset symbol: BTC
i
string
frequency interval: 24h
f
string
format: JSON, CSV
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Relative Supply by Date Bands
GET
https://api.glassnode.com/v1/metrics/supply/supply_by_date_bands_relative
This metric shows a breakdown of the relative supply by date bands. Each date band refers to the date when the UTXO was created. The metric is similar to the concept of HODL Waves, however it uses absolute date ranges instead of floating time periods.
Query Parameters
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)
Revived Supply 1+ Years
GET
https://api.glassnode.com/v1/metrics/supply/revived_more_1y_sum
The total amount of coins that come back into circulation after being untouched for at least 1 year. In other words, it is the total transfer volume of coins that were previously dormant for 1+ years.
Query Parameters
a*
string
asset symbol: BTC
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)
Revived Supply 2+ Years
GET
https://api.glassnode.com/v1/metrics/supply/revived_more_2y_sum
The total amount of coins that come back into circulation after being untouched for at least 2 years. In other words, it is the total transfer volume of coins that were previously dormant for 2+ years.
Query Parameters
a*
string
asset symbol: BTC
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)
Revived Supply 3+ Years
GET
https://api.glassnode.com/v1/metrics/supply/revived_more_3y_sum
The total amount of coins that come back into circulation after being untouched for at least 3 years. In other words, it is the total transfer volume of coins that were previously dormant for 3+ years.
Query Parameters
a*
string
asset symbol: BTC
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)
Revived Supply 5+ Years
GET
https://api.glassnode.com/v1/metrics/supply/revived_more_5y_sum
The total amount of coins that come back into circulation after being untouched for at least 5 years. In other words, it is the total transfer volume of coins that were previously dormant for 5+ years.
Query Parameters
a*
string
asset symbol: BTC
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)
Short to Long-Term Realized Value (SLRV) Ratio
GET
https://api.glassnode.com/v1/metrics/supply/sth_lth_realized_value_ratio
The Short to Long-Term Realized Value (SLRV) Ratio is the ratio of the 24h realized HODL wave and the 6m-1y realized HODL wave. It serves as a measurement for comparing short-term and long-term velocity for bear market detection. This metric was first put forward by ARK Invest.
Query Parameters
a*
string
asset symbol: BTC
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)
Short-Term Holder Profit/Loss Ratio
GET
https://api.glassnode.com/v1/metrics/supply/sth_profit_loss_ratio
The ratio of the Short-Term Holder Supply in Profit and the Short-Term Holder Supply in Loss. Similar to SOPR, it detects local bottoms in bull markets and local tops in bear markets. This metric was first put forward by ARK Invest.
Query Parameters
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)
Short-Term Holder Supply
GET
https://api.glassnode.com/v1/metrics/supply/sth_sum
The total amount of circulating supply held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Short-Term Holder Supply in Loss
GET
https://api.glassnode.com/v1/metrics/supply/sth_loss_sum
The total amount of circulating supply that is currently at loss and held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Short-Term Holder Supply in Profit
GET
https://api.glassnode.com/v1/metrics/supply/sth_profit_sum
The total amount of circulating supply that is currently in profit and held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.
Query Parameters
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)
Supply by Date Bands
GET
https://api.glassnode.com/v1/metrics/supply/supply_by_date_bands
This metric shows a breakdown of the total supply by date bands. Each date band refers to the date when the UTXO was created. The metric is similar to the concept of HODL Waves, however it uses absolute date ranges instead of floating time periods.
Query Parameters
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: USD, NATIVE
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply by TxOut Type
GET
https://api.glassnode.com/v1/metrics/supply/supply_by_txout_type
This metric breaks down the total Bitcoin supply by transaction output types. Transaction output types, or txout types for short, are determined by the type of Bitcoin script conditions that are used to lock Bitcoin in the output. The most common transaction output types are:
P2TR (Pay to Taproot): Funds are locked using a 32-byte hash that is either (1) a public key, (2) a combination of multiple public keys, or (3) a script hash.
P2WPKH (Pay to Witness Public Key Hash): The SegWit version of P2PKH.
P2WSH (Pay to Witness Script Hash): The SegWit version of P2SH. This type comes in two variants.
P2SH (Pay to Script Hash): Funds are locked using arbitrary Bitcoin script instructions.
P2PKH (Pay to Public Key Hash): The successor of P2PK, locking funds using the hash of a public key.
P2PK (Pay to Public Key): The first available type, locking funds using a public key.
Other: Serves as catch-all for all outputs whose script instructions don't match any of most commonly used output types listed above.
Query Parameters
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)
Supply in Loss
GET
https://api.glassnode.com/v1/metrics/supply/loss_sum
The circulating supply in loss, i.e. the amount of coins whose price at the time they last moved was higher than the current price. For more information see this article.
Query Parameters
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)
Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, ACH, ACX, ADP, ADS, AE, AGIX, AGLD, AGRS, AHT, AIAT, AIOZ, AIPAD, AIT, ALCX, ALD, ALEPH, ALI, ALICE, ALKI, ALPH, ALPHA, AMB, AMO, AMP, AMPL, ANGLE, ANKR, ANT, APE, APEX, APFC, API3, APRS, AQT, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, AUCTION, AUDIO, AURORA, AVA, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAL, BAND, BAT, BAX, BEAMMW, BEL, BEPRO, BETA, BFC, BGB, BICO, BIGTIME, BITRUE, BKN, BLENDR, BLUR, BMEX, BMX, BNT, BOA, BOBA, BOBT, BOND, BONE, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BTM, BUSD, BXX, BZR, BZRX, C98, CAGA, CAH, CAKE, CANTO, CAPS, CAST, CAW, CBETH, CBK, CBY, CEEK, CEL, CELL, CELR, CERE, CET, CGPT, CHEQ, CHESS, CHEX, CHR, CHRP, CHZ, CLV, COMAI, COMBO, COMP, COPI, CORGIAI, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CVC, CVP, CVX, CVXCRV, CWEB, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DF, DFI, DHT, DIA, DIONE, DKA, DMAIL, DMTR, DNT, DODO, DOGENFT, DOLA, DOMI, DOSE, DPI, DRGN, DUSK, DUST, ECOX, EDEN, EDU, EFI, EJS, EL, ELA, ELF, ELON, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ETHFI, EUL, EURS, EURT, FARM, FCT, FDUSD, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLX, FOOM, FOR, FORT, FOX, FRAX, FRM, FRONT, FTM, FTT, FUN, FUSE, FX, FXS, GAL, GALA, GEEQ, GELATO, GEOJ, GFI, GHST, GLM, GMM, GMTT, GNO, GODS, GOG, GPU, GRT, GT, GUSD, HAI, HARRYP, HEART, HEGIC, HELLO, HEMULE, HEZ, HFT, HOPR, HOT, HT, HVH, IAG, ICHI, ID, IDEX, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INV, IOTX, IPOR, IQ, ISKR, ISP, JOECOIN, JPEG, KAI, KARATE, KATA, KCS, KEEP, KEY, KISHU, KNDX, KOMPETE, KP3R, KRL, LADYS, LAI, LAMB, LBA, LDO, LEO, LEVER, LINA, LINK, LIT, LITH, LM, LMWR, LOKA, LON, LOOKS, LPT, LQTY, LRC, LSETH, LSK, LSS, LUNC, LYXE, MAGIC, MAHA, MAN, MANA, MANTLE, MAP, MARSH, MATH, MATIC, MAVIA, MBL, MC, MCADE, MCB, MCRT, META, METH, METIS, MFT, MIN, MIR, MIX, MKR, MLN, MLT, MMX, MOC, MOG, MPL, MTA, MTD, MTL, MTLX, MUBI, MUSE, MUSIC, MVL, MX, MXC, MYRIA, MYTH, NAVI, NCT, NDX, NEAR, NEST, NEXO, NFT, NFTX, NIZA, NKN, NMR, NOIA, NRG, NSURE, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OGN, OGV, OHMV2, OKB, OLAS, OM, OMG, OMI, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OVR, OX, OXT, OXY, PAAL, PANDORA, PARI, PAW, PAY, PDA, PEAS, PEOPLE, PEPE, PEPE2, PEPECOIN, PERP, PHA, PIB, PICKLE, PKF, PLU, PNK, PNT, POL, POLA, POLS, POLY, POND, POOH, PORK, PORT3, POWR, PPT, PRE, PRIME, PRNT, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUNDIX, PUSH, PYR, PYUSD, QASH, QKC, QNT, QORPO, QTCON, RACA, RAD, RADAR, RAI, RAIL, RARE, RARI, RBN, RBX, RDN, RDNT, REEF, REN, REP, REQ, RETH, REVV, REZ, RING, RLB, RLC, RMRK, ROOK, ROUTE, RPL, RSC, RSR, RSS3, RUNE, RVF, SAITA, SAITO, SAMA, SAND, SAVM, SD, SDAO, SDEX, SEAM, SENATE, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHRAP, SHX, SIDESHIFT, SIDUS, SILO, SIS, SKEB, SKEY, SKL, SLN, SMURFCATETH, SNC, SNT, SNX, SOFI, SOLVE, SOMNIUM, SORA, SOV, SPA, SPOOL, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STG, STMX, STORJ, STOS, STPT, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWFTC, SXP, SYLO, SYN, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKX, TLM, TLOS, TOKE, TOMI, TORN, TOWER, TPT, TRAC, TRIBE, TRUF, TRUMP, TRVL, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UNCX, UNFI, UNI, UNIBOT, UOS, UQC, USDC, USDD, USDE, USDP, USDT, USDY, USTC, UTK, UX, VALOR, VEGA, VERI, VEXT, VGX, VIB, VIDT, VIRTUAL, VIX, VMINT, VNM, VR, VRA, VVS, VXV, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WETH, WHALE, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WRX, WSM, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XOR, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZIG, ZKML, ZRX
Supply in Profit
GET
https://api.glassnode.com/v1/metrics/supply/profit_sum
The circulating supply in profit, i.e. the amount of coins whose price at the time they last moved was lower than the current price. For more information see this article.
Query Parameters
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)
Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, ACH, ACX, ADP, ADS, AE, AGIX, AGLD, AGRS, AHT, AIAT, AIOZ, AIPAD, AIT, ALCX, ALD, ALEPH, ALI, ALICE, ALKI, ALPH, ALPHA, AMB, AMO, AMP, AMPL, ANGLE, ANKR, ANT, APE, APEX, APFC, API3, APRS, AQT, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, AUCTION, AUDIO, AURORA, AVA, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAL, BAND, BAT, BAX, BEAMMW, BEL, BEPRO, BETA, BFC, BGB, BICO, BIGTIME, BITRUE, BKN, BLENDR, BLUR, BMEX, BMX, BNT, BOA, BOBA, BOBT, BOND, BONE, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BTM, BUSD, BXX, BZR, BZRX, C98, CAGA, CAH, CAKE, CANTO, CAPS, CAST, CAW, CBETH, CBK, CBY, CEEK, CEL, CELL, CELR, CERE, CET, CGPT, CHEQ, CHESS, CHEX, CHR, CHRP, CHZ, CLV, COMAI, COMBO, COMP, COPI, CORGIAI, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CVC, CVP, CVX, CVXCRV, CWEB, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DF, DFI, DHT, DIA, DIONE, DKA, DMAIL, DMTR, DNT, DODO, DOGENFT, DOLA, DOMI, DOSE, DPI, DRGN, DUSK, DUST, ECOX, EDEN, EDU, EFI, EJS, EL, ELA, ELF, ELON, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ETHFI, EUL, EURS, EURT, FARM, FCT, FDUSD, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLX, FOOM, FOR, FORT, FOX, FRAX, FRM, FRONT, FTM, FTT, FUN, FUSE, FX, FXS, GAL, GALA, GEEQ, GELATO, GEOJ, GFI, GHST, GLM, GMM, GMTT, GNO, GODS, GOG, GPU, GRT, GT, GUSD, HAI, HARRYP, HEART, HEGIC, HELLO, HEMULE, HEZ, HFT, HOPR, HOT, HT, HVH, IAG, ICHI, ID, IDEX, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INV, IOTX, IPOR, IQ, ISKR, ISP, JOECOIN, JPEG, KAI, KARATE, KATA, KCS, KEEP, KEY, KISHU, KNDX, KOMPETE, KP3R, KRL, LADYS, LAI, LAMB, LBA, LDO, LEO, LEVER, LINA, LINK, LIT, LITH, LM, LMWR, LOKA, LON, LOOKS, LPT, LQTY, LRC, LSETH, LSK, LSS, LUNC, LYXE, MAGIC, MAHA, MAN, MANA, MANTLE, MAP, MARSH, MATH, MATIC, MAVIA, MBL, MC, MCADE, MCB, MCRT, META, METH, METIS, MFT, MIN, MIR, MIX, MKR, MLN, MLT, MMX, MOC, MOG, MPL, MTA, MTD, MTL, MTLX, MUBI, MUSE, MUSIC, MVL, MX, MXC, MYRIA, MYTH, NAVI, NCT, NDX, NEAR, NEST, NEXO, NFT, NFTX, NIZA, NKN, NMR, NOIA, NRG, NSURE, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OGN, OGV, OHMV2, OKB, OLAS, OM, OMG, OMI, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OVR, OX, OXT, OXY, PAAL, PANDORA, PARI, PAW, PAY, PDA, PEAS, PEOPLE, PEPE, PEPE2, PEPECOIN, PERP, PHA, PIB, PICKLE, PKF, PLU, PNK, PNT, POL, POLA, POLS, POLY, POND, POOH, PORK, PORT3, POWR, PPT, PRE, PRIME, PRNT, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUNDIX, PUSH, PYR, PYUSD, QASH, QKC, QNT, QORPO, QTCON, RACA, RAD, RADAR, RAI, RAIL, RARE, RARI, RBN, RBX, RDN, RDNT, REEF, REN, REP, REQ, RETH, REVV, REZ, RING, RLB, RLC, RMRK, ROOK, ROUTE, RPL, RSC, RSR, RSS3, RUNE, RVF, SAITA, SAITO, SAMA, SAND, SAVM, SD, SDAO, SDEX, SEAM, SENATE, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHRAP, SHX, SIDESHIFT, SIDUS, SILO, SIS, SKEB, SKEY, SKL, SLN, SMURFCATETH, SNC, SNT, SNX, SOFI, SOLVE, SOMNIUM, SORA, SOV, SPA, SPOOL, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STG, STMX, STORJ, STOS, STPT, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWFTC, SXP, SYLO, SYN, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKX, TLM, TLOS, TOKE, TOMI, TORN, TOWER, TPT, TRAC, TRIBE, TRUF, TRUMP, TRVL, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UNCX, UNFI, UNI, UNIBOT, UOS, UQC, USDC, USDD, USDE, USDP, USDT, USDY, USTC, UTK, UX, VALOR, VEGA, VERI, VEXT, VGX, VIB, VIDT, VIRTUAL, VIX, VMINT, VNM, VR, VRA, VVS, VXV, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WETH, WHALE, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WRX, WSM, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XOR, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZIG, ZKML, ZRX
Supply Last Active < 24h
GET
https://api.glassnode.com/v1/metrics/supply/active_24h
The amount of circulating supply last moved in the last 24 hours.
DAI: The amount of circulating supply last moved in the last 24 hours. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved in the last 24 hours. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved in the last 24 hours. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved in the last 24 hours. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active >10y
GET
https://api.glassnode.com/v1/metrics/supply/active_more_10y
The amount of circulating supply last moved more than 10 years ago.
ETH: The amount of circulating supply last moved more than 10 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
Query Parameters
a*
string
asset symbol: BTC, ETH, TRX
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 1+ Years Ago
GET
https://api.glassnode.com/v1/metrics/supply/active_more_1y_percent
The percent of circulating supply that has not moved in at least 1 year.
Query Parameters
a*
string
asset symbol: BTC
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)
Supply Last Active 1d-1w
GET
https://api.glassnode.com/v1/metrics/supply/active_1d_1w
The amount of circulating supply last moved between 1 day and 1 week ago.
DAI: The amount of circulating supply last moved between 1 day and 1 week ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 1 day and 1 week ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 1 day and 1 week ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 1 day and 1 week ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 1m-3m
GET
https://api.glassnode.com/v1/metrics/supply/active_1m_3m
The amount of circulating supply last moved between 1 month and 3 months ago.
DAI: The amount of circulating supply last moved between 1 month and 3 months ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 1 month and 3 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 1 month and 3 months ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 1 month and 3 months ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 1w-1m
GET
https://api.glassnode.com/v1/metrics/supply/active_1w_1m
The amount of circulating supply last moved between 1 week and 1 month ago.
DAI: The amount of circulating supply last moved between 1 week and 1 month ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 1 week and 1 month ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 1 week and 1 month ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 1 week and 1 month ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 1y-2y
GET
https://api.glassnode.com/v1/metrics/supply/active_1y_2y
The amount of circulating supply last moved between 1 year and 2 years ago.
DAI: The amount of circulating supply last moved between 1 year and 2 years. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 1 year and 2 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 1 year and 2 years ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 1 year and 2 years ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 2+ Years Ago
GET
https://api.glassnode.com/v1/metrics/supply/active_more_2y_percent
The percent of circulating supply that has not moved in at least 2 years.
Query Parameters
a*
string
asset symbol: BTC
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)
Supply Last Active 2y-3y
GET
https://api.glassnode.com/v1/metrics/supply/active_2y_3y
The amount of circulating supply last moved between 2 years and 3 years ago.
DAI: The amount of circulating supply last moved between 2 years and 3 years ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 2 years and 3 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 2 years and 3 years ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 2 years and 3 years ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 3+ Years Ago
GET
https://api.glassnode.com/v1/metrics/supply/active_more_3y_percent
The percent of circulating supply that has not moved in at least 3 years.
Query Parameters
a*
string
asset symbol: BTC
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)
Supply Last Active 3m-6m
GET
https://api.glassnode.com/v1/metrics/supply/active_3m_6m
The amount of circulating supply last moved between 3 months and 6 months ago.
DAI: The amount of circulating supply last moved between 3 months and 6 months ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 3 months and 6 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 3 months and 6 months ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 3 months and 6 months ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 3y-5y
GET
https://api.glassnode.com/v1/metrics/supply/active_3y_5y
The amount of circulating supply last moved between 3 years and 5 years ago.
DAI: The amount of circulating supply last moved between 3 years and 5 years ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 3 years and 5 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 3 years and 5 years ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 3 years and 5 years ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 5+ Years Ago
GET
https://api.glassnode.com/v1/metrics/supply/active_more_5y_percent
The percent of circulating supply that has not moved in at least 5 years.
Query Parameters
a*
string
asset symbol: BTC
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)
Supply Last Active 5y-7y
GET
https://api.glassnode.com/v1/metrics/supply/active_5y_7y
The amount of circulating supply last moved between 5 years and 7 years ago.
DAI: The amount of circulating supply last moved between 5 years and 7 years ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 5 years and 7 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 5 years and 7 years ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 5 years and 7 years ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 6m-12m
GET
https://api.glassnode.com/v1/metrics/supply/active_6m_12m
The amount of circulating supply last moved between 6 months and 12 months ago.
DAI: The amount of circulating supply last moved between 6 months and 12 months ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 6 months and 12 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 6 months and 12 months ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 6 months and 12 months ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, DAI, SOL, TRX, USDC, USDT
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Supply Last Active 7y-10y
GET
https://api.glassnode.com/v1/metrics/supply/active_7y_10y
The amount of circulating supply last moved between 7 years and 10 years ago.
DAI: The amount of circulating supply last moved between 7 years and 10 years ago. Only transfer events are considered in this metric.
ETH: The amount of circulating supply last moved between 7 years and 10 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.
USDC: The amount of circulating supply last moved between 7 years and 10 years ago. Only transfer events are considered in this metric.
USDT: The amount of circulating supply last moved between 7 years and 10 years ago. Only transfer events are considered in this metric.
Query Parameters
a*
string
asset symbol: BTC, ETH, BNB, SOL, TRX
network
string
Asset Dependent. ETH values: eth, arb, aggregated
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 1h, 24h
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
Tips (Priority Fee)
GET
https://api.glassnode.com/v1/metrics/supply/tips
The Ethereum Improvement Proposal (EIP-1559), introduced as part of the London Hard Fork, established priority fees, commonly referred to as tips. These fees are paid by users to expedite their transactions, rewarding miners or validators for prioritizing them. Before the Paris upgrade, miners received these tips, but with the transition to Proof-of-Stake, validators now benefit from these additional fees. This metric provides insight into the supplementary income received by validators, beyond the base fee, for ensuring timely transaction processing on the Ethereum network.
Query Parameters
a*
string
asset symbol: ETH
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval: 10m, 1h, 24h, 1w, 1month
f
string
format: JSON, CSV
c
string
currency: NATIVE, USD
timestamp_format
string
timestamp format: unix or humanized (RFC 3339)
US Year-over-Year Supply Change
GET
https://api.glassnode.com/v1/metrics/supply/amer_1y_supply_change
This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in the US.
Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:
US: 8am to 8pm Eastern Time (13:00-01:00 UTC)
EU: 8am to 8pm Central European Time (07:00-19:00 UTC)
Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)
An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.
Query Parameters
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)
Last updated