{"uid":"cap_LROAOFa5g0TiFwdMrt0pO","slug":"onvexia-hodl-waves-441c04d4","name":"Onvexia HODL Waves","description":"Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.","url":"https://onvexia.com/v1/chain/hodl-waves","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"chain":{"type":"string","description":"Chain slug, default bitcoin"}}}},"additionalProperties":false},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"description":"The result — an array or object depending on the endpoint. An empty array means no rows in range, never that the metric is unsupported."},"meta":{"type":"object","description":"Coverage and provenance: what was measured, and what is not held. A null label means no label is held, never that the subject is safe."}}}}}}},"responseSchema":{"type":"json","example":{"data":[],"meta":{"docs":"https://onvexia.com/openapi.json","endpoint":"/v1/chain/hodl-waves"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1lkIe8d1itjyA-f2yPG8r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns HODL wave data — the distribution of coin supply by last-movement age bands — for a specified blockchain","exampleAgentPrompt":"Pull the HODL waves for bitcoin from Onvexia — I want to see the current breakdown of supply by how long coins have been sitting unmoved.","exampleUseCases":[{"title":"Long-term holder dominance check","prompt":"Show me the HODL wave data for bitcoin — I want to know what share of the supply hasn't moved in over a year right now."},{"title":"Ethereum supply age analysis","prompt":"Get me the HODL waves for Ethereum from Onvexia so I can see the age distribution of ETH supply across different holding periods."},{"title":"Market cycle conviction signal","prompt":"Pull the current bitcoin HODL wave breakdown — I'm trying to figure out how much of the supply is in short-term vs long-term hands as a market cycle signal."}],"resultDescription":"Returns an array of HODL wave data points showing on-chain coin supply segmented by age bands (e.g. 1d–1w, 1w–1m, 1m–3m, up to 5y+), along with a meta object describing data coverage, what was measured, and provenance information including a link to the OpenAPI docs.","failureModes":["Unknown or unsupported chain slug returns empty data array (not an error — per schema convention, empty array means no rows in range)","Missing chain parameter defaults to bitcoin","Response may return empty data if historical coverage for the requested chain is limited","Payment not processed results in HTTP 402 response before data is returned","Malformed query parameters may return a 4xx error"],"whenToPreferThis":"Choose this endpoint when you need on-chain supply age distribution (HODL waves) for Bitcoin or other supported chains, especially when you want historical depth back to 2008 and cross-chain coverage in a single REST call. Prefer this over generic market data APIs that lack supply-age segmentation, or over building your own UTXO/account-age analysis from raw node data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T13:05:30.090Z","isFirstParty":false}