Glassnode Docs
WebsiteStudioInsightsTwitter
  • Welcome to Glassnode
    • Introduction
      • Studio
  • 📊Data
    • General Information
      • Timestamps and Resolutions
      • Data Availability
      • Data Finalization
    • Metric Catalog
    • Supported Blockchains
    • Supported Assets
      • Market Metrics Coverage
      • On-chain Metrics Coverage
    • Point-in-Time Metrics
  • 📖Guides & Tutorials
    • Getting Started
      • Use-Case Tutorials
        • Tutorial 1 - Navigating Market Tops and Bottoms
        • Tutorial 2 - Introduction to On-chain Activity
        • Tutorial 3 - Fundamentals of Proof-of-Work Mining
        • Tutorial 4 - Introduction to Supply Dynamics
      • Get started with Glassnode Metrics
      • Granular Cohorts for Key On-Chain Metrics
    • Metric Guides
      • Market Capitalization
      • Realized Capitalization
      • MVRV
        • LTH-MVRV
        • MVRV Ratio
        • MVRV-Z Score
        • STH-MVRV
      • SOPR
        • SOPR (Spent Output Profit Ratio)
        • aSOPR (Adjusted SOPR)
        • LTH-SOPR
        • STH-SOPR
      • Unrealized Profit/Loss
        • NUPL (Net Unrealized Profit/Loss)
        • Unrealized Profit
        • Unrealized Loss
        • LTH-NUPL
        • STH-NUPL
      • Realized Profit/Loss
        • Net Realized Profit/Loss
        • Realized Profit
        • Realized Loss
      • Coin Issuance
        • Puell Multiple
      • Stablecoin
        • SSR (Stablecoin Supply Ratio)
      • Coin Days Destroyed
        • CDD (Coin Days Destroyed)
        • Supply-Adjusted CDD
        • Binary CDD
        • CYD (Coin Years Destroyed)
        • Supply-Adjusted CYD
        • Reserve Risk
      • Liveliness
      • Dormancy
        • Average Coin Dormancy
        • Supply-Adjusted Dormancy
      • Lifespan
        • Spent Output Age Bands (SOAB)
        • Average Spent Output Lifespan (ASOL)
        • Median Spent Output Lifespan (MSOL)
      • NVT
        • NVT Ratio
        • NVT Signal
        • Velocity
      • Stock to Flow
        • Stock to Flow Ratio
        • Stock to Flow Deflection
      • Price Distribution
        • URPD (UTXO Realized Price Distribution)
        • SOPD (Spent Output Price Distribution)
      • Accumulation Trend Score
      • Long and Short-Term Holder Supply
        • Supply Held by Long and Short-Term Holders
      • Profit/Loss (Supply)
        • Percent Supply in Profit
        • Supply in Profit
        • Supply in Loss
      • Age Distribution
        • HODL Waves
        • Realized Cap HODL Waves
      • Profit/Loss (UTXO)
        • Percent UTXOs in Profit
        • UTXOs in Profit
        • UTXOs in Loss
    • On-Chain Concepts
      • Entity-Adjusted Metrics
      • On-chain Glossary
      • Understanding UTXOs - The Gold Coin Analogy
      • UTXO vs. Account-Based Chains
    • Workbench Guide
  • ⚙️API
    • Introduction
    • API Key
    • API Credits
    • Metadata
    • Bulk metrics (beta)
    • Endpoints
      • Addresses
      • Bridges
      • Blockchain
      • Breakdowns
      • DeFi
      • Derivatives
      • Distribution
      • Entities
      • ETH 2.0
      • Fees
      • Indicators
      • Institutions
      • Lightning
      • Market
      • Mempool
      • Mining
      • Point-In-Time
      • Protocols
      • Signals
      • Supply
      • Transactions
  • ℹ️Further Information
    • Changelog
      • 2025
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
    • Support FAQ
    • Affiliate FAQs
    • Exchange Data: Transparency Notice
Powered by GitBook
On this page
  • Adjusted Supply
  • Asia Year-over-Year Supply Change
  • Burn Rate (Base Fee)
  • Burned Supply
  • Circulating Supply
  • EU Year-over-Year Supply Change
  • Highly Liquid Supply
  • HODL Waves
  • Illiquid Supply
  • Illiquid Supply Change
  • Inflation Rate
  • Issuance
  • Liquid and Illiquid Supply
  • Liquid Supply
  • Liquid Supply Change
  • Long-Term Holder Position Change
  • Long-Term Holder Supply
  • Long-Term Holder Supply in Loss
  • Long-Term Holder Supply in Profit
  • Minted Supply
  • Percent Supply in Profit
  • Probably Lost Supply
  • Provably Lost Supply
  • Realized Cap by Date Bands
  • Realized Cap HODL Waves
  • Relative Long/Short-Term Holder Supply
  • Relative Realized Cap by Date Bands
  • Relative Supply by Date Bands
  • Revived Supply 1+ Years
  • Revived Supply 2+ Years
  • Revived Supply 3+ Years
  • Revived Supply 5+ Years
  • Short to Long-Term Realized Value (SLRV) Ratio
  • Short-Term Holder Profit/Loss Ratio
  • Short-Term Holder Supply
  • Short-Term Holder Supply in Loss
  • Short-Term Holder Supply in Profit
  • Supply by Date Bands
  • Supply by TxOut Type
  • Supply in Loss
  • Supply in Profit
  • Supply Last Active < 24h
  • Supply Last Active >10y
  • Supply Last Active 1+ Years Ago
  • Supply Last Active 1d-1w
  • Supply Last Active 1m-3m
  • Supply Last Active 1w-1m
  • Supply Last Active 1y-2y
  • Supply Last Active 2+ Years Ago
  • Supply Last Active 2y-3y
  • Supply Last Active 3+ Years Ago
  • Supply Last Active 3m-6m
  • Supply Last Active 3y-5y
  • Supply Last Active 5+ Years Ago
  • Supply Last Active 5y-7y
  • Supply Last Active 6m-12m
  • Supply Last Active 7y-10y
  • Tips (Priority Fee)
  • US Year-over-Year Supply Change
  1. API
  2. Endpoints

Supply

PreviousSignalsNextTransactions

Last updated 1 month ago

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":15395360.42151288}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.0192300082778315}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

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

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1657.196123401}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

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

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":4377312.321296755}]
unsupported asset

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

Name
Type
Description

a*

string

asset id (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: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":19756758.54497096}]
unsupported asset

Supported asset ids: BTC, ETH, LTC, $CWIF, $MICHI, 00, 0X0, 1000SATS, 10SET, 1EX, 1INCH, A8, AAVE, ABT, ACE, ACH, ACT, ACX, ADA, ADP, ADS, ADX, AE, AERGO, AERO, AEVO, AGEUR, AGI, AGIX, AGLD, AGRS, AHT, AI, AI16Z, AIAT, AIDOGE, AIOZ, AIPAD, AIR, AIT, AIUS, AIXBT, AKT, ALCX, ALD, ALEPH, ALEX, ALGO, ALI, ALICE, ALKI, ALPACA, ALPH, ALPHA, ALT, AMB, AMO, AMP, AMPL, ANDY, ANGLE, ANIME, ANKR, ANKRETH, ANT, ANVL, ANYONE, APE, APEX, APFC, API3, APRS, APT, APU, APW, APXT, AQT, AQTIS, AR, ARB, ARC, ARIA20, ARIX, ARK, ARKM, ARPA, ASD, ASIA, AST, ASTO, ASTR, ATA, ATH, ATOM, ATOR, AUCTION, AUDIO, AURA, AURABAL, AURORA, AVA, AVAX, AVI, AVINOC, AVT, AXGT, AXL, AXS, B2M, B3, BABYDOGE, BAD, BADGER, BAG, BAKE, BAL, BAN, BANANA, BAND, BASEDAI, BAT, BAX, BB, BBL, BCH, BCUT, BEAMMW, BEER, BEL, BEN, BEPRO, BERA, BETA, BFC, BGB, BICO, BIFI, BIGTIME, BILLY, BINK, BIO, BITRUE, BKN, BLAST, BLENDR, BLOCK, BLUE, BLUR, BLZ, BMEX, BMX, BNB, BNT, BOA, BOBA, BOBAOPPA, BOBO, BOBT, BOLT, BOME, BOND, BONE, BONK, BOO, BORA, BORG, BOSON, BOTTO, BRAINLET, BREED, BRETT, BRETTFYI, BRG, BRISE, BROCCOLI, BROCK, BRWL, BST, BSV, BSW, BTM, BTRFLY, BTSE, BTT, BULLY, BURGER, BUSD, BXX, BZR, BZRX, BZZ, C98, CAGA, CAH, CAKE, CANTO, CAPS, CARV, CAST, CAT, CATE, CATI, CAW, CBBTC, CBETH, CBK, CBY, CDAI, CEEK, CEL, CELL, CELO, CELR, CENTS, CERE, CET, CETH, CETUS, CFX, CGPT, CHEEMS, CHEQ, CHESS, CHEX, CHILLGUY, CHNG, CHO, CHR, CHRP, CHZ, CKB, CLOUD, CLV, CMETH, COMAI, COMBO, COMP, COOK, COOKIE, COPI, CORE, CORGIAI, COS, COSP, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CRVUSD, CSIX, CSPR, CSWAP, CTA, CTC, CTK, CTSI, CTX, CTXC, CUDOS, CULT, CUSDC, CVC, CVP, CVX, CVXCRV, CWEB, CXO, CXT, CYBER, CYCE, D, DACXI, DAG, DAI, DAO, DAR, DASH, DATA, DC, DDX, DEAI, DEEP, DEFIT, DEGEN, DEGO, DENT, DEP, DERC, DEXE, DEXT, DEXTF, DF, DFI, DG, DGB, DHT, DIA, DIMO, DIONE, DIVI, DKA, DMAIL, DMTR, DNT, DODO, DOG, DOGE, DOGENFT, DOGS, DOLA, DOMI, DORA, DOSE, DOT, DOVU, DPAY, DPI, DRGN, DRIFT, DUCK, DUEL, DUKO, DUSK, DUST, DVF, DYM, DYPV1, ECOX, EDEN, EDU, EFI, EGLD, EIGEN, EJS, EL, ELA, ELF, ELG, ELON, EMAID, EML, ENA, ENG, ENJ, ENQAI, ENS, EOS, EPIK, ERN, ES, ETC, ETHDYDX, ETHFI, ETHW, ETHX, EUL, EURC, EURS, EURT, EVEREST, EZETH, F, FARM, FARTCOIN, FCT, FDUSD, FEG, FEI, FER, FET, FI, FIDA, FIL, FIO, FIS, FITFI, FLEX, FLIP, FLM, FLOKI, FLOW, FLR, FLT, FLUX, FLX, FOLD, FOOM, FOR, FORT, FORTH, FOX, FOXY, FPIS, FRAX, FRM, FRONT, FRXETH, FTM, FTN, FTT, FUEL, FUN, FUSE, FWOG, FX, FXS, G, GAINS, GAL, GALA, GAME, GAMMA, GAS, GBYTE, GEAR, GEEQ, GELATO, GEOJ, GET, GF, GFI, GFT, GHO, GHST, GHX, GIGA, GIKO, GINNAN, GLM, GLMR, GLQ, GME, GMEE, GMM, GMT, GMTT, GMX, GNO, GOAT, GODS, GOG, GPU, GRASS, GRG, GRIFFAIN, GROK, GRP, GRT, GSWAP, GSWIFT, GT, GTC, GTO, GUSD, GYEN, HAI, HAIR, HAPI, HARAMBE, HARRYP, HASHAI, HBAR, HBTC, HEART, HEGIC, HEHE, HEI, HELLO, HEMULE, HEZ, HFT, HIFI, HIGH, HIPPO, HIVE, HMSTR, HNT, HOGE, HOOK, HOPPY, HOPR, HOT, HPO, HT, HUNT, HVH, HXRO, HYPE, IAG, ICHI, ICP, ICX, ID, IDEX, IDRT, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INST, INV, IO, IOST, IOTX, IPOR, IQ, IRIS, ISKR, ISP, IXS, J, JAILSTOOL, JASMY, JBX, JELLYJELLY, JESUS, JMPT, JOE, JOECOIN, JPEG, JST, JTO, JUP, KAI, KAITO, KAP, KARATE, KARRAT, KAS, KATA, KAVA, KCS, KDA, KEEP, KEY, KHAI, KISHU, KIZUNA, KLAY, KMNO, KNC, KNCL, KNDX, KOMA, KOMPETE, KP3R, KRL, KSM, KUJI, L3, LADYS, LAI, LAMB, LBA, LBTC, LCX, LDO, LEASH, LEO, LEOX, LEVER, LIME, LINA, LINK, LISTA, LIT, LITH, LM, LMEOW, LMR, LMWR, LNQ, LOCKIN, LOKA, LON, LOOKS, LOOM, LORDS, LOVELY, LPT, LQTY, LRC, LSETH, LSK, LSS, LTO, LUCE, LUMIA, LUNA, LUNC, LUNR, LUSD, LYXE, M87, MAGIC, MAHA, MAN, MANA, MANC, MANEKI, MANTA, MANTLE, MAP, MARSH, MASA, MASK, MASQ, MATH, MATIC, MAV, MAVIA, MAX, MAZZE, MBL, MBOX, MC, MCADE, MCB, MCRT, MDT, ME, MEME, META, METH, METIS, MEW, MFT, MIM, MIN, MINA, MINI, MIOTA, MIR, MIX, MKR, ML, MLK, MLN, MLT, MMX, MNW, MOBILE, MOC, MOCA, MOG, MON, MOODENG, MORPHO, MOTHER, MOVE, MOVR, MPL, MTA, MTD, MTL, MTLX, MUBI, MUMU, MUSE, MUSIC, MV, MVI, MVL, MVP, MX, MXC, MYRIA, MYRO, MYTH, NANO, NAVI, NC, NCDT, NCT, NEAR, NEIRO, NEO, NEST, NETVR, NEURAL, NEXO, NEXT, NFD, NFT, NFTX, NGL, NIZA, NKN, NMR, NMT, NOIA, NOT, NPC, NPCS, NPXS, NRG, NSURE, NTRN, NTX, NUB, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OETHER, OG, OGN, OGV, OHM, OHMV2, OKB, OLAS, OM, OMG, OMI, OMIKAMI, OMNIC, OMNINET, ONDO, ONE, ONGAS, ONIT, ONT, OOE, OOKI, OP, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORCA, ORDER, ORDI, ORDS, ORN, OSAK, OSETH, OSMO, OUSD, OVR, OX, OXT, OXY, PAAL, PAID, PALM, PANDORA, PARI, PAW, PAXG, PAY, PDA, PDT, PEAQ, PEAS, PENDLE, PENG, PEOPLE, PEPE, PEPE2, PEPECOIN, PERC, PERP, PHA, PHB, PIB, PICKLE, PIRATE, PIXEL, PKF, PLANET, PLU, PLUME, PNDC, PNK, PNT, PNUT, POL, POLA, POLS, POLY, POLYX, POND, PONKE, POOH, POOLZ, POPCAT, PORK, PORT3, PORTAL, POWR, PPT, PRCL, PRE, PREMIA, PRIME, PRNT, PRO, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUFF, PUFFER, PUNDIX, PUSH, PYR, PYTH, PYUSD, QAI, QANX, QASH, QI, QKC, QNT, QOM, QORPO, QTCON, QTUM, QUICK, QUICKOLD, QUIL, RACA, RAD, RADAR, RAI, RAIL, RAMP, RARE, RARI, RATS, RAY, RBN, RBX, RDN, RDNT, RDT, REEF, REI, REN, RENBTC, RENDER, REP, REQ, RETARDIO, RETH, REVV, REZ, RFOX, RIF, RING, RISE, RIZZMAS, RLB, RLC, RLY, RMRK, RONIN, ROOK, ROSE, ROUTE, RPG, RPL, RSC, RSETH, RSR, RSS3, RUNE, RVF, RVN, RVST, RWA, S, SAFE, SAFEMOON, SAGA, SAI, SAITA, SAITO, SAMA, SAMO, SAND, SATS, SAVM, SC, SCA, SCF, SCIHUB, SCRT, SD, SDAO, SDEX, SEAM, SEI, SELFIE, SENATE, SEND, SENT, SETH2, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHINA, SHIRO, SHOPX, SHRAP, SHX, SIDESHIFT, SIDUS, SIGMA, SILLY, SILO, SIPHER, SIS, SKBDI, SKEB, SKEY, SKL, SLERF, SLF, SLG, SLN, SLP, SMURFCATETH, SNC, SNT, SNX, SOFI, SOL, SOLO, SOLV, SOLVE, SOMM, SOMNIUM, SONIC, SORA, SOUL, SOV, SPA, SPECTRE, SPELL, SPOOL, SPX, SQT, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STEEM, STETH, STFX, STG, STMX, STORJ, STOS, STPT, STRAX, STRIKE, STRK, STRP, STRUMP, STX, SUI, SUKU, SUN, SUNDOG, SUPER, SURE, SUSD, SUSHI, SWAP, SWARMS, SWASH, SWEAT, SWELL, SWETH, SWFTC, SWISE, SXP, SYLO, SYN, SYRUP, SYS, T, TAI, TAIKO, TALK, TAO, TARA, TBTC, TEL, TENET, TET, THALES, THE, THETA, THOR, TIA, TIME, TKO, TKP, TKX, TLM, TLOS, TNSR, TOKE, TOKEN, TOMI, TON, TOOKER, TOPIA, TORN, TOSHI, TOWER, TPRO, TPT, TRAC, TRADE, TRB, TRIAS, TRIBE, TROY, TRU, TRUF, TRUMP, TRVL, TRX, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, TWT, UBT, UDS, UFI, UFO, UFT, ULTI, UMA, UMB, UNCX, UNFI, UNI, UNIBOT, UNIETH, UOS, UPP, UQC, USDC, USDD, USDE, USDP, USDT, USDY, USTC, USUAL, UTK, UX, VAIOT, VALOR, VANA, VANRY, VCX, VEE, VEGA, VELO, VERI, VET, VEXT, VGX, VIB, VIDT, VINE, VINU, VIRTUAL, VITA, VITE, VIX, VLX, VMINT, VNM, VOLT, VOXEL, VR, VRA, VRO, VTHO, VVS, VVV, VXV, W, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WEETH, WEN, WETH, WEXO, WHALE, WHITE, WIF, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WRX, WSM, WSTETH, WXT, X, XAI, XAUT, XCAD, XCH, XCN, XDAO, XDB, XDC, XDEFI, XEM, XEN, XETA, XFI, XIDO, XION, XLM, XMR, XOR, XPLA, XPR, XPRT, XRD, XRP, XRT, XSGD, XSUSHI, XT, XTM, XTP, XTZ, XVG, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZBCN, ZCX, ZEC, ZEN, ZENT, ZEREBRO, ZETA, ZEUS, ZIG, ZIL, ZK, ZKB, ZKF, ZKJ, ZKML, ZRO, 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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.03577729264428722}]
unsupported asset

Highly Liquid Supply

GET https://api.glassnode.com/v1/metrics/supply/highly_liquid_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":3675264.3871852797}]
unsupported asset

HODL Waves

GET https://api.glassnode.com/v1/metrics/supply/hodl_waves

Query Parameters

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"1d_1w":0.017356953426726413,"1m_3m":0.07160078924011061,"1w_1m":0.037802585086087956,"1y_2y":0.1200905883160282,"24h":0.01204628611781315,"2y_3y":0.07653042900548959,"3m_6m":0.07585009082280825,"3y_5y":0.1500357384288819,"5y_7y":0.08843614493824489,"6m_12m":0.12949565321979445,"7y_10y":0.053359003227931565,"more_10y":0.16739573817008307}}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

Illiquid Supply

GET https://api.glassnode.com/v1/metrics/supply/illiquid_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":14366871.506594187}]
unsupported asset

Illiquid Supply Change

GET https://api.glassnode.com/v1/metrics/supply/illiquid_change

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":123238.74092952721}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.008406385024656293}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":453.125}]
unsupported asset

Liquid and Illiquid Supply

GET https://api.glassnode.com/v1/metrics/supply/liquid_illiquid_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"highly_liquid":3675264.3871852797,"illiquid":14366871.506594187,"liquid":1714622.6511913443}}]
unsupported asset

Liquid Supply

GET https://api.glassnode.com/v1/metrics/supply/liquid_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1714622.6511913443}]
unsupported asset

Liquid Supply Change

GET https://api.glassnode.com/v1/metrics/supply/liquid_change

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":-109685.61592952721}]
unsupported asset

Long-Term Holder Position Change

GET https://api.glassnode.com/v1/metrics/supply/lth_net_change

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":257886.70216021687}]
unsupported asset

Long-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/lth_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":14208486.557278614}]
unsupported asset

Long-Term Holder Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/lth_loss_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":900848.5708359804}]
unsupported asset

Long-Term Holder Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/lth_profit_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":13307637.986393733}]
unsupported asset

Minted Supply

GET https://api.glassnode.com/v1/metrics/supply/minted

The total amount of issued ETH.

Query Parameters

Name
Type
Description

a*

string

asset id: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

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

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":124791892.95099808}]
unsupported asset

Percent Supply in Profit

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

Query Parameters

Name
Type
Description

a*

string

asset id (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: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.8497818770215475}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, 0X0, 10SET, 1EX, 1INCH, A8, AAVE, ABT, ACH, ACT, ACX, ADP, ADS, ADX, AE, AERGO, AEVO, AGEUR, AGI, AGIX, AGLD, AGRS, AHT, AI16Z, AIAT, AIOZ, AIPAD, AIR, AIT, AIUS, ALCX, ALD, ALEPH, ALEX, ALI, ALICE, ALKI, ALPH, ALPHA, ALT, AMB, AMO, AMP, AMPL, ANDY, ANGLE, ANKR, ANKRETH, ANT, ANVL, ANYONE, APE, APEX, APFC, API3, APRS, APU, APW, APXT, AQT, AQTIS, ARB, ARIA20, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, ATH, AUCTION, AUDIO, AURA, AURABAL, AURORA, AVA, AVI, AVINOC, AVT, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAG, BAL, BAN, BANANA, BAND, BASEDAI, BAT, BAX, BBL, BCUT, BEAMMW, BEER, BEL, BEN, BEPRO, BETA, BFC, BGB, BICO, BIFI, BIGTIME, BILLY, BITRUE, BKN, BLENDR, BLUR, BLZ, BMEX, BMX, BNB, BNT, BOA, BOBA, BOBO, BOBT, BOLT, BOME, BOND, BONE, BONK, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BST, BTM, BTRFLY, BTSE, BTT, BULLY, BUSD, BXX, BZR, BZRX, BZZ, C98, CAGA, CAH, CAKE, CANTO, CAPS, CARV, CAST, CATE, CAW, CBBTC, CBETH, CBK, CBY, CDAI, CDT, CEEK, CEL, CELL, CELR, CENTS, CERE, CET, CETH, CGPT, CHEQ, CHESS, CHEX, CHILLGUY, CHNG, CHO, CHR, CHRP, CHZ, CLV, CMETH, COMAI, COMBO, COMP, COPI, CORGIAI, COS, COSP, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CRVUSD, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CUSDC, CVC, CVP, CVX, CVXCRV, CWEB, CXO, CXT, CYBER, CYCE, DACXI, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DEXTF, DF, DFI, DG, DHT, DIA, DIMO, DIVI, DKA, DMAIL, DMTR, DNT, DODO, DOGE, DOGENFT, DOLA, DOMI, DORA, DOSE, DOVU, DPAY, DPI, DRGN, DUEL, DUKO, DUSK, DUST, DVF, DYPV1, ECOX, EDEN, EDU, EFI, EIGEN, EJS, EL, ELA, ELF, ELG, ELON, EMAID, EML, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ERN, ES, ETHDYDX, ETHFI, ETHX, EUL, EURC, EURS, EURT, EVEREST, EZETH, F, FARM, FARTCOIN, FCT, FDUSD, FEG, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLT, FLUX, FLX, FOLD, FOOM, FOR, FORT, FORTH, FOX, FPIS, FRAX, FRM, FRONT, FRXETH, FTM, FTN, FTT, FUN, FUSE, FWOG, FX, FXS, G, GAINS, GAL, GALA, GAME, GAMMA, GBYTE, GEAR, GEEQ, GELATO, GEOJ, GET, GF, GFI, GHO, GHST, GHX, GINNAN, GLM, GMEE, GMM, GMT, GMTT, GNO, GOAT, GODS, GOG, GPU, GRASS, GRG, GROK, GRP, GRT, GSWAP, GSWIFT, GT, GTC, GTO, GUSD, GYEN, HAI, HAIR, HAPI, HARRYP, HASHAI, HBTC, HEART, HEGIC, HEHE, HELLO, HEMULE, HEZ, HFT, HIFI, HNT, HOGE, HOPPY, HOPR, HOT, HPO, HT, HUNT, HVH, HXRO, IAG, ICHI, ID, IDEX, IDRT, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INST, INV, IOTX, IPOR, IQ, IRIS, ISKR, ISP, IXS, JASMY, JBX, JESUS, JMPT, JOECOIN, JPEG, JTO, JUP, KAI, KAP, KARATE, KARRAT, KATA, KCS, KEEP, KEY, KHAI, KISHU, KIZUNA, KNC, KNCL, KNDX, KOMPETE, KP3R, KRL, KUJI, LADYS, LAI, LAMB, LBA, LBTC, LCX, LDO, LEASH, LEO, LEOX, LEVER, LIME, LINA, LINK, LIT, LITH, LM, LMEOW, LMR, LMWR, LNQ, LOKA, LON, LOOKS, LOOM, LORDS, LOVELY, LPT, LQTY, LRC, LSETH, LSK, LSS, LTO, LUCE, LUNR, LUSD, LYXE, M87, MAGIC, MAHA, MAN, MANA, MANC, MANTLE, MAP, MARSH, MASK, MASQ, MATH, MATIC, MAV, MAVIA, MAZZE, MC, MCADE, MCB, MCRT, MDT, MELANIA, MEME, META, METH, METIS, MEW, MFT, MIM, MIN, MIR, MIX, MKR, ML, MLN, MLT, MMX, MNW, MOC, MOCA, MOG, MON, MOODENG, MORPHO, MOTHER, MPL, MTA, MTD, MTL, MTLX, MUBI, MUMU, MUSE, MUSIC, MV, MVI, MVL, MVP, MX, MXC, MYRIA, MYTH, NAVI, NCDT, NCT, NEAR, NEIRO, NEST, NETVR, NEURAL, NEXO, NEXT, NFD, NFT, NFTX, NGL, NIZA, NKN, NMR, NMT, NOIA, NPC, NPCS, NPXS, NRG, NSURE, NTX, NUB, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OETHER, OFFICIAL-TRUMP, OGN, OGV, OHM, OHMV2, OKB, OL, OLAS, OM, OMG, OMI, OMIKAMI, OMNIC, OMNINET, ONDO, ONIT, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OSETH, OSMO, OUSD, OVR, OX, OXT, OXY, PAAL, PAID, PALM, PANDORA, PARI, PAW, PAXG, PAY, PDA, PDT, PEAS, PENDLE, PENG, PENGU, PEOPLE, PEPE, PEPE2, PEPECOIN, PERC, PERP, PHA, PIB, PICKLE, PIXEL, PKF, PLANET, PLU, PNDC, PNK, PNT, PNUT, POL, POLA, POLS, POLY, POND, PONKE, POOH, POOLZ, POPCAT, PORK, PORT3, PORTAL, POWR, PPT, PRE, PREMIA, PRIME, PRNT, PRO, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUFF, PUFFER, PUNDIX, PUSH, PYR, PYTH, PYUSD, QAI, QANX, QASH, QKC, QNT, QOM, QORPO, QTCON, QUICK, QUICKOLD, QUIL, RACA, RAD, RADAR, RAI, RAIL, RAMP, RARE, RARI, RAY, RBN, RBX, RDN, RDNT, RDT, REEF, REKT, REN, RENBTC, REP, REQ, RETH, REVV, REZ, RFOX, RING, RISE, RLB, RLC, RLY, RMRK, ROOK, ROUTE, RPG, RPL, RSC, RSETH, RSR, RSS3, RUNE, RVF, RVST, RWA, SAFE, SAFEMOON, SAI, SAITA, SAITO, SAMA, SAMO, SAND, SAVM, SCF, SCIHUB, SD, SDAO, SDEX, SEAM, SELFIE, SENATE, SENT, SETH2, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHINA, SHIRO, SHOPX, SHRAP, SHX, SIDESHIFT, SIDUS, SIGMA, SILO, SIPHER, SIS, SKEB, SKEY, SKL, SLERF, SLN, SLP, SMURFCATETH, SNC, SNT, SNX, SOFI, SOL, SOLVE, SOMM, SOMNIUM, SORA, SOV, SPA, SPECTRE, SPELL, SPOOL, SPX, SQT, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STFX, STG, STMX, STORJ, STOS, STPT, STRIKE, STRK, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWELL, SWETH, SWFTC, SWISE, SXP, SYLO, SYN, SYRUP, T, TAIKO, TALK, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKP, TKX, TLM, TLOS, TOKE, TOKEN, TOMI, TON, TOOKER, TOPIA, TORN, TOWER, TPRO, TPT, TRAC, TRADE, TRB, TRIAS, TRIBE, TRU, TRUF, TRUMP, TRVL, TRX, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UMB, UNCX, UNFI, UNI, UNIBOT, UNIETH, UOS, UQC, USDC, USDD, USDE, USDP, USDS, USDT, USDY, USTC, UTK, UX, VAIOT, VALOR, VANRY, VCX, VEE, VEGA, VERI, VEXT, VGX, VIB, VIDT, VINU, VIRTUAL, VITA, VITE, VIX, VLX, VMINT, VNM, VOLT, VR, VRA, VRO, VVS, VXV, W, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WEETH, WEN, WETH, WEXO, WHALE, WHITE, WIF, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WSM, WSTETH, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XFI, XIDO, XOR, XPR, XPRT, XRP, XRT, XSGD, XSUSHI, XT, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZEREBRO, ZETA, ZIG, ZKB, ZKJ, ZKML, ZRO, 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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1456451.45200909}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"burn":0.0000276,"cumsum":3320.09478662,"op_return":3.0000000000000004e-8,"unclaimed":0}}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"2009":53835.772371900086,"2010":56154.48351182419,"2011":2827875.8212535726,"2012":1977776.2754074717,"2013":127126652.71202087,"2014":167007975.44768557,"2015":55184731.3223106,"2016":179316150.13631305,"2017":5148644927.208835,"2018":6982235664.455655,"2019":5091545187.164195,"2020":13742946344.62602,"2021":102644686250.8963,"2022":48054698927.767944,"2023":73666154952.18791,"2024":369748658936.909}}]
unsupported asset

Realized Cap HODL Waves

GET https://api.glassnode.com/v1/metrics/supply/rcap_hodl_waves

Query Parameters

Name
Type
Description

a*

string

asset id: BTC, BNB, DOGE, SOL, TON, TRX, XRP

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"1d_1w":0.03314494607057061,"1m_3m":0.13932192117586092,"1w_1m":0.07010910137759004,"1y_2y":0.09156255741770968,"24h":0.02407659236424906,"2y_3y":0.09401409818069294,"3m_6m":0.16076398556149624,"3y_5y":0.15021803756647423,"5y_7y":0.023009555707319024,"6m_12m":0.21088693407609235,"7y_10y":0.0024447484222072835,"more_10y":0.00044752207973771014}}]
unsupported asset

Relative Long/Short-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/lth_sth_profit_loss_relative

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"lth_loss":0.05384887913537364,"lth_profit":0.7954737485364746,"sth_loss":0.06491311644272371,"sth_profit":0.08574849035881368}}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"2009":8.60528183460447e-8,"2010":8.975912030345816e-8,"2011":0.000004520167049345092,"2012":0.0000031613407787865125,"2013":0.00020320330276302003,"2014":0.0002669508830348216,"2015":0.00008820903742495098,"2016":0.00028662466264246176,"2017":0.008229758525404604,"2018":0.011160628533979942,"2019":0.00813848847686282,"2020":0.0219671644564501,"2021":0.16407054549375238,"2022":0.07681216587622507,"2023":0.11775033534507218,"2024":0.5910180680866208}}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"2009":0.055037960175748975,"2010":0.03811958096923419,"2011":0.02524301980081789,"2012":0.01145356824344601,"2013":0.025290654812893772,"2014":0.014932329616112319,"2015":0.00981535586434961,"2016":0.016238631162131843,"2017":0.04454178040713123,"2018":0.04332566865826158,"2019":0.035156527802735815,"2020":0.05413315747743487,"2021":0.10757145632373744,"2022":0.09222849124979922,"2023":0.12320496490371305,"2024":0.30370685253245217}}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":8857.367147500001}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2567.74792178}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1829.7668924900001}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":843.01273685}]
unsupported asset

Short to Long-Term Realized Value (SLRV) Ratio

GET https://api.glassnode.com/v1/metrics/supply/sth_lth_realized_value_ratio

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.11416825072511001}]
unsupported asset

Short-Term Holder Profit/Loss Ratio

GET https://api.glassnode.com/v1/metrics/supply/sth_profit_loss_ratio

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1.3209732494429554}]
unsupported asset

Short-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/sth_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2520711.622896835}]
unsupported asset

Short-Term Holder Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/sth_loss_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1085944.3894631306}]
unsupported asset

Short-Term Holder Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/sth_profit_sum

Query Parameters

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1434503.488863458}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"2009":1087371.69,"2010":753119.35704463,"2011":498720.24715068,"2012":226285.38226411,"2013":499661.36058255,"2014":295014.43073945,"2015":193919.61584492002,"2016":320822.71497108,"2017":880001.20066681,"2018":855974.77448069,"2019":694579.03107821,"2020":1069495.72155857,"2021":2125263.28891897,"2022":1822136.03258925,"2023":2434130.7431442803,"2024":6000262.95393676}}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"total_other":2724.3246246500003,"total_p2pk":1723949.59799878,"total_p2pkh":7062482.81151742,"total_p2sh":4211660.82499212,"total_p2tr":76733.79212456,"total_p2wpkh":5464332.36023638,"total_p2wsh":1214874.83347705}}]
unsupported asset

Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/loss_sum

Query Parameters

Name
Type
Description

a*

string

asset id (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: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2966367.04389942}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, 0X0, 10SET, 1EX, 1INCH, A8, AAVE, ABT, ACH, ACT, ACX, ADP, ADS, ADX, AE, AERGO, AEVO, AGEUR, AGI, AGIX, AGLD, AGRS, AHT, AI16Z, AIAT, AIOZ, AIPAD, AIR, AIT, AIUS, ALCX, ALD, ALEPH, ALEX, ALI, ALICE, ALKI, ALPH, ALPHA, ALT, AMB, AMO, AMP, AMPL, ANDY, ANGLE, ANKR, ANKRETH, ANT, ANVL, ANYONE, APE, APEX, APFC, API3, APRS, APU, APW, APXT, AQT, AQTIS, ARB, ARIA20, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, ATH, AUCTION, AUDIO, AURA, AURABAL, AURORA, AVA, AVI, AVINOC, AVT, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAG, BAL, BAN, BANANA, BAND, BASEDAI, BAT, BAX, BBL, BCUT, BEAMMW, BEER, BEL, BEN, BEPRO, BETA, BFC, BGB, BICO, BIFI, BIGTIME, BILLY, BITRUE, BKN, BLENDR, BLUR, BLZ, BMEX, BMX, BNB, BNT, BOA, BOBA, BOBO, BOBT, BOLT, BOME, BOND, BONE, BONK, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BST, BTM, BTRFLY, BTSE, BTT, BULLY, BUSD, BXX, BZR, BZRX, BZZ, C98, CAGA, CAH, CAKE, CANTO, CAPS, CARV, CAST, CATE, CAW, CBBTC, CBETH, CBK, CBY, CDAI, CDT, CEEK, CEL, CELL, CELR, CENTS, CERE, CET, CETH, CGPT, CHEQ, CHESS, CHEX, CHILLGUY, CHNG, CHO, CHR, CHRP, CHZ, CLV, CMETH, COMAI, COMBO, COMP, COPI, CORGIAI, COS, COSP, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CRVUSD, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CUSDC, CVC, CVP, CVX, CVXCRV, CWEB, CXO, CXT, CYBER, CYCE, DACXI, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DEXTF, DF, DFI, DG, DHT, DIA, DIMO, DIVI, DKA, DMAIL, DMTR, DNT, DODO, DOGE, DOGENFT, DOLA, DOMI, DORA, DOSE, DOVU, DPAY, DPI, DRGN, DUEL, DUKO, DUSK, DUST, DVF, DYPV1, ECOX, EDEN, EDU, EFI, EIGEN, EJS, EL, ELA, ELF, ELG, ELON, EMAID, EML, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ERN, ES, ETHDYDX, ETHFI, ETHX, EUL, EURC, EURS, EURT, EVEREST, EZETH, F, FARM, FARTCOIN, FCT, FDUSD, FEG, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLT, FLUX, FLX, FOLD, FOOM, FOR, FORT, FORTH, FOX, FPIS, FRAX, FRM, FRONT, FRXETH, FTM, FTN, FTT, FUN, FUSE, FWOG, FX, FXS, G, GAINS, GAL, GALA, GAME, GAMMA, GBYTE, GEAR, GEEQ, GELATO, GEOJ, GET, GF, GFI, GHO, GHST, GHX, GINNAN, GLM, GMEE, GMM, GMT, GMTT, GNO, GOAT, GODS, GOG, GPU, GRASS, GRG, GROK, GRP, GRT, GSWAP, GSWIFT, GT, GTC, GTO, GUSD, GYEN, HAI, HAIR, HAPI, HARRYP, HASHAI, HBTC, HEART, HEGIC, HEHE, HELLO, HEMULE, HEZ, HFT, HIFI, HNT, HOGE, HOPPY, HOPR, HOT, HPO, HT, HUNT, HVH, HXRO, IAG, ICHI, ID, IDEX, IDRT, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INST, INV, IOTX, IPOR, IQ, IRIS, ISKR, ISP, IXS, JASMY, JBX, JESUS, JMPT, JOECOIN, JPEG, JTO, JUP, KAI, KAP, KARATE, KARRAT, KATA, KCS, KEEP, KEY, KHAI, KISHU, KIZUNA, KNC, KNCL, KNDX, KOMPETE, KP3R, KRL, KUJI, LADYS, LAI, LAMB, LBA, LBTC, LCX, LDO, LEASH, LEO, LEOX, LEVER, LIME, LINA, LINK, LIT, LITH, LM, LMEOW, LMR, LMWR, LNQ, LOKA, LON, LOOKS, LOOM, LORDS, LOVELY, LPT, LQTY, LRC, LSETH, LSK, LSS, LTO, LUCE, LUNR, LUSD, LYXE, M87, MAGIC, MAHA, MAN, MANA, MANC, MANTLE, MAP, MARSH, MASK, MASQ, MATH, MATIC, MAV, MAVIA, MAZZE, MC, MCADE, MCB, MCRT, MDT, MELANIA, MEME, META, METH, METIS, MEW, MFT, MIM, MIN, MIR, MIX, MKR, ML, MLN, MLT, MMX, MNW, MOC, MOCA, MOG, MON, MOODENG, MORPHO, MOTHER, MPL, MTA, MTD, MTL, MTLX, MUBI, MUMU, MUSE, MUSIC, MV, MVI, MVL, MVP, MX, MXC, MYRIA, MYTH, NAVI, NCDT, NCT, NEAR, NEIRO, NEST, NETVR, NEURAL, NEXO, NEXT, NFD, NFT, NFTX, NGL, NIZA, NKN, NMR, NMT, NOIA, NPC, NPCS, NPXS, NRG, NSURE, NTX, NUB, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OETHER, OFFICIAL-TRUMP, OGN, OGV, OHM, OHMV2, OKB, OL, OLAS, OM, OMG, OMI, OMIKAMI, OMNIC, OMNINET, ONDO, ONIT, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OSETH, OSMO, OUSD, OVR, OX, OXT, OXY, PAAL, PAID, PALM, PANDORA, PARI, PAW, PAXG, PAY, PDA, PDT, PEAS, PENDLE, PENG, PENGU, PEOPLE, PEPE, PEPE2, PEPECOIN, PERC, PERP, PHA, PIB, PICKLE, PIXEL, PKF, PLANET, PLU, PNDC, PNK, PNT, PNUT, POL, POLA, POLS, POLY, POND, PONKE, POOH, POOLZ, POPCAT, PORK, PORT3, PORTAL, POWR, PPT, PRE, PREMIA, PRIME, PRNT, PRO, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUFF, PUFFER, PUNDIX, PUSH, PYR, PYTH, PYUSD, QAI, QANX, QASH, QKC, QNT, QOM, QORPO, QTCON, QUICK, QUICKOLD, QUIL, RACA, RAD, RADAR, RAI, RAIL, RAMP, RARE, RARI, RAY, RBN, RBX, RDN, RDNT, RDT, REEF, REKT, REN, RENBTC, REP, REQ, RETH, REVV, REZ, RFOX, RING, RISE, RLB, RLC, RLY, RMRK, ROOK, ROUTE, RPG, RPL, RSC, RSETH, RSR, RSS3, RUNE, RVF, RVST, RWA, SAFE, SAFEMOON, SAI, SAITA, SAITO, SAMA, SAMO, SAND, SAVM, SCF, SCIHUB, SD, SDAO, SDEX, SEAM, SELFIE, SENATE, SENT, SETH2, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHINA, SHIRO, SHOPX, SHRAP, SHX, SIDESHIFT, SIDUS, SIGMA, SILO, SIPHER, SIS, SKEB, SKEY, SKL, SLERF, SLN, SLP, SMURFCATETH, SNC, SNT, SNX, SOFI, SOL, SOLVE, SOMM, SOMNIUM, SORA, SOV, SPA, SPECTRE, SPELL, SPOOL, SPX, SQT, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STFX, STG, STMX, STORJ, STOS, STPT, STRIKE, STRK, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWELL, SWETH, SWFTC, SWISE, SXP, SYLO, SYN, SYRUP, T, TAIKO, TALK, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKP, TKX, TLM, TLOS, TOKE, TOKEN, TOMI, TON, TOOKER, TOPIA, TORN, TOWER, TPRO, TPT, TRAC, TRADE, TRB, TRIAS, TRIBE, TRU, TRUF, TRUMP, TRVL, TRX, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UMB, UNCX, UNFI, UNI, UNIBOT, UNIETH, UOS, UQC, USDC, USDD, USDE, USDP, USDS, USDT, USDY, USTC, UTK, UX, VAIOT, VALOR, VANRY, VCX, VEE, VEGA, VERI, VEXT, VGX, VIB, VIDT, VINU, VIRTUAL, VITA, VITE, VIX, VLX, VMINT, VNM, VOLT, VR, VRA, VRO, VVS, VXV, W, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WEETH, WEN, WETH, WEXO, WHALE, WHITE, WIF, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WSM, WSTETH, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XFI, XIDO, XOR, XPR, XPRT, XRP, XRT, XSGD, XSUSHI, XT, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZEREBRO, ZETA, ZIG, ZKB, ZKJ, ZKML, ZRO, ZRX

Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/profit_sum

Query Parameters

Name
Type
Description

a*

string

asset id (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: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":16788935.36020692}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, 0X0, 10SET, 1EX, 1INCH, A8, AAVE, ABT, ACH, ACT, ACX, ADP, ADS, ADX, AE, AERGO, AEVO, AGEUR, AGI, AGIX, AGLD, AGRS, AHT, AI16Z, AIAT, AIOZ, AIPAD, AIR, AIT, AIUS, ALCX, ALD, ALEPH, ALEX, ALI, ALICE, ALKI, ALPH, ALPHA, ALT, AMB, AMO, AMP, AMPL, ANDY, ANGLE, ANKR, ANKRETH, ANT, ANVL, ANYONE, APE, APEX, APFC, API3, APRS, APU, APW, APXT, AQT, AQTIS, ARB, ARIA20, ARIX, ARKM, ARPA, ASD, ASIA, AST, ASTO, ATA, ATH, AUCTION, AUDIO, AURA, AURABAL, AURORA, AVA, AVI, AVINOC, AVT, AXGT, AXL, AXS, B2M, BABYDOGE, BAD, BADGER, BAG, BAL, BAN, BANANA, BAND, BASEDAI, BAT, BAX, BBL, BCUT, BEAMMW, BEER, BEL, BEN, BEPRO, BETA, BFC, BGB, BICO, BIFI, BIGTIME, BILLY, BITRUE, BKN, BLENDR, BLUR, BLZ, BMEX, BMX, BNB, BNT, BOA, BOBA, BOBO, BOBT, BOLT, BOME, BOND, BONE, BONK, BOO, BORA, BORG, BOSON, BOTTO, BREED, BRG, BRISE, BROCK, BRWL, BST, BTM, BTRFLY, BTSE, BTT, BULLY, BUSD, BXX, BZR, BZRX, BZZ, C98, CAGA, CAH, CAKE, CANTO, CAPS, CARV, CAST, CATE, CAW, CBBTC, CBETH, CBK, CBY, CDAI, CDT, CEEK, CEL, CELL, CELR, CENTS, CERE, CET, CETH, CGPT, CHEQ, CHESS, CHEX, CHILLGUY, CHNG, CHO, CHR, CHRP, CHZ, CLV, CMETH, COMAI, COMBO, COMP, COPI, CORGIAI, COS, COSP, COTI, COVAL, COW, CPOOL, CQT, CRE, CREAM, CREDI, CREO, CRO, CRTS, CRU, CRV, CRVUSD, CSIX, CSWAP, CTA, CTC, CTSI, CTX, CTXC, CUDOS, CULT, CUSDC, CVC, CVP, CVX, CVXCRV, CWEB, CXO, CXT, CYBER, CYCE, DACXI, DAG, DAI, DAO, DAR, DATA, DC, DDX, DEAI, DEFIT, DEGO, DENT, DEP, DERC, DEXE, DEXT, DEXTF, DF, DFI, DG, DHT, DIA, DIMO, DIVI, DKA, DMAIL, DMTR, DNT, DODO, DOGE, DOGENFT, DOLA, DOMI, DORA, DOSE, DOVU, DPAY, DPI, DRGN, DUEL, DUKO, DUSK, DUST, DVF, DYPV1, ECOX, EDEN, EDU, EFI, EIGEN, EJS, EL, ELA, ELF, ELG, ELON, EMAID, EML, ENA, ENG, ENJ, ENQAI, ENS, EPIK, ERN, ES, ETHDYDX, ETHFI, ETHX, EUL, EURC, EURS, EURT, EVEREST, EZETH, F, FARM, FARTCOIN, FCT, FDUSD, FEG, FEI, FER, FET, FI, FIS, FLEX, FLIP, FLOKI, FLT, FLUX, FLX, FOLD, FOOM, FOR, FORT, FORTH, FOX, FPIS, FRAX, FRM, FRONT, FRXETH, FTM, FTN, FTT, FUN, FUSE, FWOG, FX, FXS, G, GAINS, GAL, GALA, GAME, GAMMA, GBYTE, GEAR, GEEQ, GELATO, GEOJ, GET, GF, GFI, GHO, GHST, GHX, GINNAN, GLM, GMEE, GMM, GMT, GMTT, GNO, GOAT, GODS, GOG, GPU, GRASS, GRG, GROK, GRP, GRT, GSWAP, GSWIFT, GT, GTC, GTO, GUSD, GYEN, HAI, HAIR, HAPI, HARRYP, HASHAI, HBTC, HEART, HEGIC, HEHE, HELLO, HEMULE, HEZ, HFT, HIFI, HNT, HOGE, HOPPY, HOPR, HOT, HPO, HT, HUNT, HVH, HXRO, IAG, ICHI, ID, IDEX, IDRT, ILV, IMGNAI, IMX, INDEX, INJ, INSP, INST, INV, IOTX, IPOR, IQ, IRIS, ISKR, ISP, IXS, JASMY, JBX, JESUS, JMPT, JOECOIN, JPEG, JTO, JUP, KAI, KAP, KARATE, KARRAT, KATA, KCS, KEEP, KEY, KHAI, KISHU, KIZUNA, KNC, KNCL, KNDX, KOMPETE, KP3R, KRL, KUJI, LADYS, LAI, LAMB, LBA, LBTC, LCX, LDO, LEASH, LEO, LEOX, LEVER, LIME, LINA, LINK, LIT, LITH, LM, LMEOW, LMR, LMWR, LNQ, LOKA, LON, LOOKS, LOOM, LORDS, LOVELY, LPT, LQTY, LRC, LSETH, LSK, LSS, LTO, LUCE, LUNR, LUSD, LYXE, M87, MAGIC, MAHA, MAN, MANA, MANC, MANTLE, MAP, MARSH, MASK, MASQ, MATH, MATIC, MAV, MAVIA, MAZZE, MC, MCADE, MCB, MCRT, MDT, MELANIA, MEME, META, METH, METIS, MEW, MFT, MIM, MIN, MIR, MIX, MKR, ML, MLN, MLT, MMX, MNW, MOC, MOCA, MOG, MON, MOODENG, MORPHO, MOTHER, MPL, MTA, MTD, MTL, MTLX, MUBI, MUMU, MUSE, MUSIC, MV, MVI, MVL, MVP, MX, MXC, MYRIA, MYTH, NAVI, NCDT, NCT, NEAR, NEIRO, NEST, NETVR, NEURAL, NEXO, NEXT, NFD, NFT, NFTX, NGL, NIZA, NKN, NMR, NMT, NOIA, NPC, NPCS, NPXS, NRG, NSURE, NTX, NUB, NULS, NUM, NVIR, NWC, NXRA, NYM, OAX, OBSR, OCEAN, OCT, OETHER, OFFICIAL-TRUMP, OGN, OGV, OHM, OHMV2, OKB, OL, OLAS, OM, OMG, OMI, OMIKAMI, OMNIC, OMNINET, ONDO, ONIT, OOE, OOKI, OPEN, OPSEC, OPTI, OPUL, ORAI, ORB, ORBS, ORDS, ORN, OSAK, OSETH, OSMO, OUSD, OVR, OX, OXT, OXY, PAAL, PAID, PALM, PANDORA, PARI, PAW, PAXG, PAY, PDA, PDT, PEAS, PENDLE, PENG, PENGU, PEOPLE, PEPE, PEPE2, PEPECOIN, PERC, PERP, PHA, PIB, PICKLE, PIXEL, PKF, PLANET, PLU, PNDC, PNK, PNT, PNUT, POL, POLA, POLS, POLY, POND, PONKE, POOH, POOLZ, POPCAT, PORK, PORT3, PORTAL, POWR, PPT, PRE, PREMIA, PRIME, PRNT, PRO, PROM, PROPC, PROS, PRQ, PSP, PSPS, PSTAKE, PSWAP, PTU, PUFF, PUFFER, PUNDIX, PUSH, PYR, PYTH, PYUSD, QAI, QANX, QASH, QKC, QNT, QOM, QORPO, QTCON, QUICK, QUICKOLD, QUIL, RACA, RAD, RADAR, RAI, RAIL, RAMP, RARE, RARI, RAY, RBN, RBX, RDN, RDNT, RDT, REEF, REKT, REN, RENBTC, REP, REQ, RETH, REVV, REZ, RFOX, RING, RISE, RLB, RLC, RLY, RMRK, ROOK, ROUTE, RPG, RPL, RSC, RSETH, RSR, RSS3, RUNE, RVF, RVST, RWA, SAFE, SAFEMOON, SAI, SAITA, SAITO, SAMA, SAMO, SAND, SAVM, SCF, SCIHUB, SD, SDAO, SDEX, SEAM, SELFIE, SENATE, SENT, SETH2, SFP, SFRXETH, SFUND, SHFT, SHIB, SHIDO, SHINA, SHIRO, SHOPX, SHRAP, SHX, SIDESHIFT, SIDUS, SIGMA, SILO, SIPHER, SIS, SKEB, SKEY, SKL, SLERF, SLN, SLP, SMURFCATETH, SNC, SNT, SNX, SOFI, SOL, SOLVE, SOMM, SOMNIUM, SORA, SOV, SPA, SPECTRE, SPELL, SPOOL, SPX, SQT, SQUIDGROW, SRM, SSV, STAKE, STARL, STAT, STBU, STETH, STFX, STG, STMX, STORJ, STOS, STPT, STRIKE, STRK, STRP, STRUMP, SUKU, SUPER, SURE, SUSD, SUSHI, SWAP, SWASH, SWEAT, SWELL, SWETH, SWFTC, SWISE, SXP, SYLO, SYN, SYRUP, T, TAIKO, TALK, TARA, TBTC, TEL, TENET, TET, THALES, THOR, TIME, TKP, TKX, TLM, TLOS, TOKE, TOKEN, TOMI, TON, TOOKER, TOPIA, TORN, TOWER, TPRO, TPT, TRAC, TRADE, TRB, TRIAS, TRIBE, TRU, TRUF, TRUMP, TRVL, TRX, TRYB, TSUKA, TT, TURBOT, TUSD, TVK, UBT, UDS, UFI, UFO, UFT, UMA, UMB, UNCX, UNFI, UNI, UNIBOT, UNIETH, UOS, UQC, USDC, USDD, USDE, USDP, USDS, USDT, USDY, USTC, UTK, UX, VAIOT, VALOR, VANRY, VCX, VEE, VEGA, VERI, VEXT, VGX, VIB, VIDT, VINU, VIRTUAL, VITA, VITE, VIX, VLX, VMINT, VNM, VOLT, VR, VRA, VRO, VVS, VXV, W, WAGMIGAMES, WALLET, WAMPL, WAVES, WAXP, WBETH, WBT, WBTC, WCFG, WEETH, WEN, WETH, WEXO, WHALE, WHITE, WIF, WIKEN, WILD, WING, WISE, WLD, WMT, WNXM, WOJAK, WOO, WRLD, WSM, WSTETH, WXT, XAUT, XCAD, XCN, XDAO, XDB, XDEFI, XEN, XETA, XFI, XIDO, XOR, XPR, XPRT, XRP, XRT, XSGD, XSUSHI, XT, XTM, XTP, XVS, XYO, YAM, YFI, YFII, YGG, YLD, ZCX, ZENT, ZEREBRO, ZETA, ZIG, ZKB, ZKJ, ZKML, ZRO, 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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":237995.56619327}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":3307197.1804835103}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BOME, BONK, BULLY, CENTS, CHILLGUY, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, TOOKER, TRX, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id: BTC, BNB, DOGE, SOL, TON, TRX, XRP

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.6558476420866591}]
unsupported asset

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":342917.13792814}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1414599.50464622}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":746856.54592156}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2372600.75688328}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.5357570537706311}]
unsupported asset

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1511993.2072045}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.4592266247651415}]
unsupported asset

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1498551.93000034}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2964219.85725584}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.3091908863362595}]
unsupported asset

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1747211.56219296}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2558414.35328677}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DAI, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TON, TOOKER, TRX, USDC, USDT, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id (see list below for more details)

network

string

Asset Dependent. ETH values: eth, arb, aggregated

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1054200.94297457}]
unsupported asset

Supported asset ids: BTC, ETH, $MICHI, ACT, AI16Z, BAN, BEER, BILLY, BNB, BOME, BONK, BULLY, CENTS, CHILLGUY, DOGE, DUKO, FARTCOIN, FWOG, GINNAN, GMT, GOAT, GRASS, HEHE, HNT, JTO, JUP, KHAI, LUCE, MELANIA, MEW, MOODENG, MOTHER, MUMU, NPCS, NUB, OFFICIAL-TRUMP, PENG, PENGU, PNUT, PONKE, POPCAT, PYTH, RAY, SAMO, SCF, SCIHUB, SELFIE, SIGMA, SLERF, SOL, TOOKER, TRX, W, WEN, WIF, XRP, ZEREBRO

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

Name
Type
Description

a*

string

asset id: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

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

f

string

format: csv, json

c

string

currency: native, usd

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":669.3944274664966}]
unsupported asset

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

Name
Type
Description

a*

string

asset id: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: csv, json

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":-0.05500730092211875}]
unsupported asset

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 .

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

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 .

The monthly (30d) net change of supply held by illiquid entities. For more information see our .

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 .

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 .

The monthly (30d) net change of supply held by liquid and highly liquid entities. For more information see our .

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

The total amount of circulating supply held by long term holders. Long- and Short-Term Holder supply is defined with respect to the with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 .

weighted by . The idea for this visualization of HODL waves was first introduced by .

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 .

The ratio of the and the . Similar to SOPR, it detects local bottoms in bull markets and local tops in bear markets. This metric was first put forward by .

The total amount of circulating supply held by short term holders. Long- and Short-Term Holder supply is defined with respect to the with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

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 .

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 .

⚙️
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
introductory article on Bitcoin liquidity
View in Studio
this post
Unchained Capital
View in Studio
introductory article on Bitcoin liquidity
View in Studio
introductory article on Bitcoin liquidity
View in Studio
View in Studio
View in Studio
introductory article on Bitcoin liquidity
View in Studio
introductory article on Bitcoin liquidity
View in Studio
introductory article on Bitcoin liquidity
View in Studio
entity's averaged purchasing date
View in Studio
entity's averaged purchasing date
View in Studio
entity's averaged purchasing date
View in Studio
entity's averaged purchasing date
View in Studio
View in Studio
this article
View in Studio
View in Studio
View in Studio
View in Studio
HODL Waves
Realized Price
@typerbole
View in Studio
entity's averaged purchasing date
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
ARK Invest
View in Studio
Short-Term Holder Supply in Profit
Short-Term Holder Supply in Loss
ARK Invest
View in Studio
entity's averaged purchasing date
View in Studio
entity's averaged purchasing date
View in Studio
entity's averaged purchasing date
View in Studio
View in Studio
View in Studio
this article
View in Studio
this article
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio