{"uid":"cap_cfzKn7CHwSJeiEzogfib0","slug":"glassnode-hodl-waves-d01032dc","name":"Glassnode HODL Waves","description":"HODL Waves — A bundle of all active supply age bands. Each colored band shows the percentage of supply in existence that was last moved within the time period denoted in the legend, so every vertical slice sums to 100%. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/supply/hodl_waves","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["a"],"properties":{"a":{"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native"],"type":"string","description":"Currency for denominated values, e.g. usd, native"},"f":{"enum":["csv","json"],"type":"string","description":"Response format: json or csv"},"i":{"enum":["24h"],"type":"string","description":"Time interval / resolution, e.g. 24h, 1w, 1month"},"network":{"enum":["aggregated","arb","base","eth","opt","sol","ton","trx"],"type":"string","description":"Network / blockchain identifier for cross-chain metrics"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"o":{"type":"object"},"t":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pd6utM2ilcuNIr6oN5jIm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the HODL Waves supply age band distribution, showing what percentage of Bitcoin supply was last moved within each time period, summing to 100% per day.","exampleAgentPrompt":"Pull the latest Glassnode HODL Waves data for BTC in JSON format so I can see how the Bitcoin supply is distributed across different holding age bands.","exampleUseCases":null,"resultDescription":"An array of timestamped objects, each containing an object with fractional supply values for each HODL wave age band (e.g. 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-12m, 1y-2y, 2y-3y, 3y-5y, 5y+), representing what percentage of the total supply was last moved within that time window. Each vertical slice across all bands sums to 100%.","failureModes":["Missing required 'a' (asset) parameter returns 400 error","Unsupported asset symbol returns empty or error response","Payment not processed via x402 protocol returns 402 Payment Required","Invalid 'i' interval value (only '24h' supported) returns validation error","Network parameter incompatible with BTC asset may return empty data","Rate limiting or payment failure returns 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need to analyze the age distribution of Bitcoin (or supported asset) supply over time, understand long-term vs short-term holder behavior, detect accumulation or distribution trends via coin age bands, or replicate the classic Glassnode HODL Waves visualization. Prefer this over simple price or volume endpoints when on-chain behavioral analysis of holder cohorts is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:00:45.205Z","isFirstParty":false}