{"uid":"cap_hpvBlg9Wb92rq4UBDF92K","slug":"token-holder-address-density-distribution-histogram-8046b65e","name":"Token Holder-Address Density Distribution Histogram","description":"Token holder-address density — Distribution histogram: Distribution histogram for Token holder-address density. Supplied token observations only. Deterministic calculation or caller-threshold verdict, not a live scan, safety proof or trade recommendation. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one bounded distribution histogram report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-holders-per-million-histogram?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"bins":{"type":"integer","default":5,"maximum":30,"minimum":1},"rows":{"type":"array","items":{"type":"object","required":["holders","market_cap_usd"],"properties":{"holders":{"type":"number","default":1000,"maximum":10000000000000000,"minimum":0,"exclusiveMinimum":0},"market_cap_usd":{"type":"number","default":2000000,"maximum":10000000000000000,"minimum":0,"exclusiveMinimum":0}},"additionalProperties":false},"default":[{"holders":1000,"market_cap_usd":2000000},{"holders":1100,"market_cap_usd":2200000},{"holders":1000,"market_cap_usd":2000000},{"holders":1100,"market_cap_usd":2200000}],"maxItems":200,"minItems":2}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JlTA_O7Eq-vZstljtIL0A","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a distribution histogram of token holder-address density (holders per million USD of market cap) from supplied token observations, grouped into configurable bins.","exampleAgentPrompt":"Can you generate a holder-address density histogram for these 5 tokens — split into 10 bins — using their holder counts and market caps: Token A has 50,000 holders and $5M market cap, Token B has 120,000 holders and $20M market cap, Token C has 8,000 holders and $800K market cap, Token D has 200,000 holders and $50M market cap, Token E has 15,000 holders and $3M market cap?","exampleUseCases":[{"title":"Compare holder concentration across a token portfolio","prompt":"I have 8 tokens I'm researching — can you build a 5-bin histogram of their holder-address density so I can see which density ranges most of them fall into? Here are the holder counts and market caps: [1200, $1.5M], [3400, $2M], [800, $900K], [50000, $8M], [12000, $5M], [900, $1.1M], [200000, $40M], [75000, $15M]."},{"title":"Spot outliers in token holder distribution","prompt":"Run a 15-bin holder density histogram on these 6 token observations so I can spot any outliers: Token 1 has 500 holders and $200K market cap, Token 2 has 1M holders and $100M cap, Token 3 has 2500 holders and $1M cap, Token 4 has 30000 holders and $10M cap, Token 5 has 80000 holders and $60M cap, Token 6 has 400 holders and $500K cap."},{"title":"Evaluate token decentralization spread","prompt":"For a decentralization analysis, can you histogram the holder density of these 4 tokens into 3 bins? Token A: 10,000 holders, $4M market cap; Token B: 500 holders, $2M market cap; Token C: 75,000 holders, $25M market cap; Token D: 3,000 holders, $900K market cap."}],"resultDescription":"Returns a bounded distribution histogram report showing how supplied token observations are distributed across bins by their holder-address density (holders per million USD of market cap), including bin ranges and observation counts per bin — deterministically calculated from the supplied data with no live scanning.","failureModes":["Fewer than 2 token observation rows provided — minimum is 2","holder or market_cap_usd values are zero or negative — both require exclusiveMinimum > 0","bins value exceeds 30 or is less than 1 — clamped to allowed range","More than 200 rows submitted — maxItems limit exceeded","Missing required fields (holders or market_cap_usd) in any row — validation error","Payment of 0.01 USDC not provided or rejected — x402 payment required"],"whenToPreferThis":"Choose this endpoint when you need a statistical distribution histogram of token holder density (holders per million USD market cap) across a batch of up to 200 supplied token observations. It is ideal for portfolio-level analysis, spotting concentration outliers, or segmenting tokens into density buckets without requiring live blockchain scanning. Prefer this over raw ratio calculations when you need binned frequency distribution output suitable for visualization or reporting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T18:48:07.857Z","isFirstParty":false,"canonicalSlug":"token-holder-address-density-distribution-histogram-8046b65e"}