{"uid":"cap_DZ7k5I2D9FtF7W6BwYVlP","slug":"largest-token-holder-share-batch-calculation-a14cddeb","name":"Largest Token Holder Share — Batch Calculation","description":"Largest reported token holder share — Batch calculation: Batch 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 batch calculation report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-largest-holder-batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","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},"default":[{"holder_tokens":100000,"circulating_tokens":1000000},{"holder_tokens":110000.00000000001,"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_uj1-UCffh0ERTNadjpLum","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 largest reported token holder share (as a percentage of circulating supply) for a batch of up to 200 token observations in a single call.","exampleAgentPrompt":"Can you calculate the largest holder share for these two token observations: one where the top holder owns 100,000 tokens out of 1,000,000 circulating, and another where they own 110,000 out of 1,100,000 circulating?","exampleUseCases":[{"title":"Portfolio token concentration audit","prompt":"I have a list of 20 tokens I'm considering investing in — can you calculate the largest holder share for each one? Here are the holder token counts and circulating supplies: token A has 500,000 holder tokens and 5,000,000 circulating, token B has 2,000,000 holder tokens and 8,000,000 circulating, and so on."},{"title":"DeFi protocol whale risk check","prompt":"Before we list these 5 new DeFi tokens on our platform, can you batch-calculate the largest holder percentage for each? I want to flag any where the top holder controls more than 20% of supply. Here are the holder and circulating token numbers for each."},{"title":"Tokenomics report for multiple projects","prompt":"I'm writing a tokenomics comparison report — can you compute the dominant holder share percentage for these 10 token projects at once? Each has a different top-holder balance and circulating supply figure I'll give you."}],"resultDescription":"A batch report containing the computed largest holder share percentage (holder_tokens / circulating_tokens) for each row submitted, delivered as deterministic calculation results. No live blockchain scan or trade recommendation is included — results are based solely on the supplied numeric observations.","failureModes":["Validation error if circulating_tokens is 0 or negative (exclusiveMinimum enforced)","Batch exceeds 200 rows — request rejected","holder_tokens or circulating_tokens missing from a row — row-level validation failure","holder_tokens exceeds maximum value (1e16) — schema rejection","Payment not included or insufficient — x402 payment required error"],"whenToPreferThis":"Choose this endpoint when you need to compute largest holder concentration ratios for multiple token observations in a single API call (up to 200 rows), and you already have the holder token counts and circulating supply figures on hand. It is a deterministic arithmetic calculation — ideal for batch tokenomics analysis, risk screening, or portfolio audits — rather than a live blockchain query or safety verdict service.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:47:52.308Z","isFirstParty":false,"canonicalSlug":"largest-token-holder-share-batch-calculation-a14cddeb"}