{"uid":"cap_CmPzMEktVk8sQCYBDfxia","slug":"glassnode-holder-retention-rate-398495e1","name":"Glassnode Holder Retention Rate","description":"Holder Retention Rate — Holder Retention Rate is the percentage of addresses that maintain a balance of the asset across consecutive 30-day periods. It is calculated by dividing the number of addresses currently holding a balance (including new holders, resurrected holders, and all retained holder categories) by the total number of addresses that held a balance at any point during the observation period. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/addresses/holder_retention_rate","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"}}}},"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_zWST6rPNatXky4Mj26otI","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 percentage of addresses that maintained a balance of a crypto asset across consecutive 30-day periods","exampleAgentPrompt":"Pull the Glassnode holder retention rate for BTC in JSON format — I want to see what percentage of Bitcoin addresses have kept their balance across consecutive 30-day periods.","exampleUseCases":null,"resultDescription":"An array of time-series data points, each with a Unix timestamp (t) and a numeric value (v) representing the holder retention rate as a percentage for the given asset and interval.","failureModes":["Missing required asset symbol 'a' parameter returns a 400 or validation error","Invalid or unsupported asset symbol returns empty data or error","Payment not provided or invalid results in 402 Payment Required","Unsupported interval value for 'i' parameter returns an error","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need on-chain data specifically measuring how many addresses retain a crypto balance across consecutive 30-day windows — ideal for gauging holder conviction, stickiness, and long-term sentiment rather than price-based or transaction-volume metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:31:52.374Z","isFirstParty":false}