{"uid":"cap_5SO2EvwjJEnjsMjY73px5","slug":"chainquery-hodl-waves-history-6c3a3882","name":"ChainQuery HODL Waves History","description":"ChainQuery Bitcoin Intelligence: independent Bitcoin-native on-chain data over x402, no API key. Full HODL-waves history: supply split across 12 age bands per weekly snapshot.","url":"https://intel.chainquery.com/v1/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"as_of":{"description":"data freshness timestamp"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QRb3bG5bEHdcLVczMxvS8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full HODL-waves history for Bitcoin: weekly snapshots of total BTC supply split across 12 coin-age bands","exampleAgentPrompt":"Pull the full HODL waves history for Bitcoin from ChainQuery and show me how the supply is currently distributed across the 12 coin-age bands, including when the data was last updated.","exampleUseCases":null,"resultDescription":"A time-series dataset of weekly Bitcoin supply snapshots, each broken down into 12 coin-age bands (e.g. <1 day, 1d–1w, 1w–1m, 1m–3m, 3m–6m, 6m–12m, 1y–2y, 2y–3y, 3y–5y, 5y–7y, 7y–10y, 10y+), showing what percentage or absolute amount of BTC supply falls into each age cohort per snapshot, plus an as_of timestamp indicating data freshness.","failureModes":["Payment failure or insufficient USDC balance returns 402 Payment Required","Network timeout if the dataset is large or the backend is slow","Malformed or missing query params return 400 Bad Request","Service unavailable returns 503 if backend indexer is down or catching up to chain tip","Stale data if the weekly snapshot has not yet been computed for the most recent period"],"whenToPreferThis":"Use this endpoint when you need the full historical HODL waves dataset for Bitcoin — specifically the multi-year, weekly-resolution supply distribution across all 12 coin-age bands. Prefer this over other on-chain data providers when you want no API key setup (pay-per-call via x402/USDC), independent Bitcoin-native data, and comprehensive age-band granularity rather than just a single current snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:36.749Z","isFirstParty":false}