{"uid":"cap_4NCthl0kkrpi-sm_h7aJN","slug":"reported-top-holder-group-share-record-ranking-a9f582d7","name":"Reported Top-Holder Group Share — Record Ranking","description":"Reported top-holder group share — Record ranking: Record ranking 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 record ranking report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-top-group-rank?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},{"group_tokens":400000,"circulating_tokens":1000000},{"group_tokens":440000.00000000006,"circulating_tokens":1100000}],"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_XhvaV1bUcNhPLGu8SJwda","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":"Ranks a batch of token observations by the reported top-holder group share (group tokens / circulating tokens), returning a deterministic record ranking for each row.","exampleAgentPrompt":"Rank these 4 token observations by top-holder group share: first has 400000 group tokens out of 1000000 circulating, second has 440000 group tokens out of 1100000 circulating, third has 400000 out of 1000000, fourth has 440000 out of 1100000 — give me the record ranking for each.","exampleUseCases":[{"title":"Token holder concentration screening","prompt":"I have 5 tokens I'm researching — can you rank them by how concentrated the top-holder group share is? Here are the figures: Token A has 500000 group tokens and 2000000 circulating, Token B has 300000 group tokens and 800000 circulating, Token C has 1200000 group tokens and 5000000 circulating, Token D has 200000 group tokens and 600000 circulating, Token E has 900000 group tokens and 3000000 circulating."},{"title":"Portfolio concentration risk ranking","prompt":"For my portfolio tokens, rank them by reported top-holder group share so I can see which ones have the most concentrated ownership — Token X: 750000 group tokens, 2500000 circulating; Token Y: 100000 group tokens, 4000000 circulating; Token Z: 3000000 group tokens, 6000000 circulating."},{"title":"Comparing two token launches","prompt":"Can you rank these two newly launched tokens by their top-holder group share? Token Alpha has 800000 group tokens out of 1600000 circulating supply, and Token Beta has 950000 group tokens out of 2500000 circulating supply."}],"resultDescription":"A deterministic record ranking for each submitted token observation row, ordered or scored by the computed top-holder group share ratio (group_tokens / circulating_tokens). Returns a bounded ranking report across the supplied rows — not a live scan or safety verdict.","failureModes":["Fewer than 2 rows submitted (minItems violation)","More than 200 rows submitted (maxItems violation)","circulating_tokens is zero or negative (exclusiveMinimum violation)","group_tokens or circulating_tokens exceed maximum allowed value","Malformed row objects missing required fields","Payment failure or insufficient USDC balance"],"whenToPreferThis":"Use this endpoint when you need a deterministic, comparative ranking of multiple token observations by their reported top-holder group share ratio. It is well-suited for batch analysis (2–200 rows) of token holder concentration without requiring live chain access. Prefer this over live-scan tools when you already have the group and circulating token figures and need a reproducible ranking report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:48:01.943Z","isFirstParty":false,"canonicalSlug":"reported-top-holder-group-share-record-ranking-a9f582d7"}