{"uid":"cap_NTaUhtNyTXHRxmBXfBcsr","slug":"glassnode-entities-supply-distribution-relative-d32e6d65","name":"Glassnode Entities Supply Distribution Relative","description":"Entities Supply Distribution — The relative distribution of the circulating supply held by entities, broken down by balance band. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/entities/supply_distribution_relative","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"],"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":{"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_ZiRLXZYrVysn78S2le01y","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 relative distribution of Bitcoin's circulating supply held by on-chain entities, broken down by balance band (cohort).","exampleAgentPrompt":"Can you pull the latest Glassnode on-chain data showing how Bitcoin's circulating supply is relatively distributed across different entity balance bands — I want to see which cohorts hold what share of supply?","exampleUseCases":null,"resultDescription":"Returns a time-series array of objects, each with a timestamp (t) and a nested object (o) containing percentage values for each entity balance band (e.g. entities holding 0-0.001 BTC, 0.001-0.01 BTC, up to 10k+ BTC), representing each cohort's relative share of circulating BTC supply.","failureModes":["Missing required 'a' (asset) query parameter returns 400 error","Unsupported asset symbol (non-BTC) returns validation error since only BTC is supported","Payment not included or insufficient USDC balance causes 402 Payment Required","Invalid interval or format enum value returns schema validation error","Network timeout or Glassnode data unavailability returns 5xx error"],"whenToPreferThis":"Choose this endpoint when you need on-chain cohort-level supply distribution data for Bitcoin — specifically the relative (percentage) breakdown of circulating supply across entity balance bands. Prefer this over raw address-level data when you want aggregated entity-level analysis (Glassnode clusters addresses into entities). Use this over absolute supply distribution when you need normalized percentages rather than raw BTC amounts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:12.758Z","isFirstParty":false}