{"uid":"cap_NlvX6JCyzh4fmcNKg4zz0","slug":"reported-top-holder-group-share-batch-calculation-3e61f0d4","name":"Reported Top-Holder Group Share — Batch Calculation","description":"Reported top-holder group share — Batch calculation: Batch calculation for Reported top-holder group 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 batch calculation report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-top-group-batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","required":["group_tokens","circulating_tokens"],"properties":{"group_tokens":{"type":"number","default":400000,"maximum":10000000000000000,"minimum":0},"circulating_tokens":{"type":"number","default":1000000,"maximum":10000000000000000,"minimum":0,"exclusiveMinimum":0}},"additionalProperties":false},"default":[{"group_tokens":400000,"circulating_tokens":1000000},{"group_tokens":440000.00000000006,"circulating_tokens":1100000}],"maxItems":200,"minItems":1}}},"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_pJCZ012K8LJXphQib1-gI","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 reported top-holder group share (percentage of circulating supply held by a token group) for multiple token observations in a single batch request.","exampleAgentPrompt":"Can you batch-calculate the top-holder group share for two token observations: one where the group holds 400,000 tokens out of 1,000,000 circulating, and another where the group holds 440,000 out of 1,100,000 circulating?","exampleUseCases":[{"title":"Token concentration screening for portfolio","prompt":"I have a list of tokens I'm researching — for each one I know how many tokens the top holder group owns and the total circulating supply. Can you batch-calculate the group share percentage for all of them so I can see which tokens are most concentrated?"},{"title":"Pre-launch token distribution audit","prompt":"Before we launch this token, I want to check our distribution: the founding group holds 5,000,000 tokens and total circulating supply will be 20,000,000. Also run a second scenario where circulating supply is 25,000,000. What's the top-holder group share in each case?"},{"title":"Comparing holder concentration across snapshots","prompt":"I have three historical snapshots of a token — group holdings were 300,000, 350,000, and 420,000 tokens, with circulating supplies of 900,000, 1,000,000, and 1,200,000 respectively. Can you batch-calculate the group share for each snapshot so I can see how concentration changed over time?"}],"resultDescription":"Returns a batch report containing the computed top-holder group share (as a percentage or ratio) for each supplied row of group_tokens and circulating_tokens. The result is a deterministic calculation based solely on the provided token observations — not a live scan or real-time chain query. Each row yields a group share figure, and optionally a threshold-based verdict if a caller threshold is configured.","failureModes":["circulating_tokens must be greater than 0 (exclusiveMinimum enforced) — a value of 0 will cause a validation error","group_tokens or circulating_tokens exceeding the maximum (10^16) will be rejected","Submitting an empty rows array (minItems:1 not met) will fail","Submitting more than 200 rows (maxItems:200) will be rejected","Malformed row objects missing required fields group_tokens or circulating_tokens will fail schema validation","Payment failure or insufficient USDC balance will prevent the request from being processed"],"whenToPreferThis":"Prefer this endpoint when you need to compute top-holder group share for multiple token observations in a single call rather than making repeated single-row requests. It is best suited for deterministic, offline-style concentration calculations where you already have the group token count and circulating supply — not for live chain scanning or real-time holder lookups. Use this when you want a fast, cheap ($0.01 USDC) batch computation across up to 200 token rows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:48:24.205Z","isFirstParty":false,"canonicalSlug":"reported-top-holder-group-share-batch-calculation-3e61f0d4"}