{"uid":"cap_gWJZQe_qnvloGaVyHQcLL","slug":"largest-token-holder-share-target-gap-calculator-8d9c923e","name":"Largest Token Holder Share — Target Gap Calculator","description":"Largest reported token holder share — Target gap calculation: Target gap calculation for Largest reported token holder share. 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 target gap calculation report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-largest-holder-target-gap?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"number","default":100,"maximum":1000000000000000000,"minimum":-1000000000000000000},"values":{"type":"object","default":{"holder_tokens":100000,"circulating_tokens":1000000},"required":["holder_tokens","circulating_tokens"],"properties":{"holder_tokens":{"type":"number","default":100000,"maximum":10000000000000000,"minimum":0},"circulating_tokens":{"type":"number","default":1000000,"maximum":10000000000000000,"minimum":0,"exclusiveMinimum":0}},"additionalProperties":false}}},"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_gW3VhXH_yLDxy_XgpdQoJ","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":"Calculates the gap between the current largest token holder share and a specified target share percentage.","exampleAgentPrompt":"Calculate the gap between the largest token holder share and a target of 15% — the holder holds 100,000 tokens out of 1,000,000 circulating tokens.","exampleUseCases":[{"title":"Token concentration risk assessment","prompt":"For a token where the biggest holder owns 250,000 tokens out of 2,000,000 circulating, calculate the gap to a 10% target concentration threshold — I want to know how far off they are."},{"title":"DeFi governance threshold check","prompt":"Check whether a whale holding 500,000 tokens out of 4,000,000 circulating meets or exceeds a 12% governance control target, and tell me the gap."},{"title":"Token distribution compliance review","prompt":"We have a circulating supply of 10,000,000 tokens and the largest holder has 800,000 — calculate the gap to our internal 5% target for maximum single-holder concentration."}],"resultDescription":"Returns a deterministic target gap calculation report showing the current largest holder share as a percentage and the numeric difference (gap) between that share and the specified target value, based solely on the supplied holder_tokens and circulating_tokens inputs.","failureModes":["circulating_tokens set to zero causes division error","holder_tokens exceeds circulating_tokens producing share above 100%","target value outside acceptable numeric range triggers validation error","missing required values fields returns schema validation error","non-numeric inputs for holder or circulating tokens cause rejection"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic calculation of how far the largest token holder's share deviates from a target threshold, using caller-supplied token counts rather than live on-chain data. Prefer this over live-scan services when you already have the token observation data and need a cheap ($0.01 USDC), reproducible arithmetic result without any trading recommendation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T12:39:19.283Z","isFirstParty":false,"canonicalSlug":"largest-token-holder-share-target-gap-calculator-8d9c923e"}