{"uid":"cap_yXKzhxlD50pXCbj8gWneA","slug":"glassnode-lth-supply-sum-long-term-holder-total-supply-3faf6080","name":"Glassnode LTH Supply Sum — Long-Term Holder Total Supply","description":"Total Supply Held by Long-Term Holders — The total amount of circulating supply held by long-term holders. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/supply/lth_sum","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":{"enum":["BTC"],"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native","usd"],"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"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number"},"v":{"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_6UnW9ykb8H5sqIY8Ncyti","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 total amount of BTC circulating supply held by long-term holders (LTH) as a time series","exampleAgentPrompt":"Pull the Glassnode long-term holder total supply metric for Bitcoin in native BTC units so I can see how much BTC long-term holders currently control.","exampleUseCases":null,"resultDescription":"A time series array of objects, each with a Unix timestamp ('t') and a numeric value ('v') representing the total BTC supply held by long-term holders at that point in time. Data is returned in JSON format at 24h resolution.","failureModes":["Missing required 'a' (asset) parameter returns 400 error","Unsupported asset symbol returns validation error","Payment not included or insufficient USDC returns 402 Payment Required","Invalid query parameter enum values (e.g. unsupported interval) return 400","Rate limiting or network timeouts may return 429 or 503"],"whenToPreferThis":"Choose this endpoint when you need on-chain Bitcoin supply data specifically attributed to long-term holders (LTH), sourced from Glassnode's proprietary methodology. Prefer this over generic price or market cap APIs when the analysis requires understanding HODLer behavior, supply distribution, or conviction-based accumulation trends.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:59:18.838Z","isFirstParty":false}