{"uid":"cap_s0Ivi8bgQotkSCaOTkonI","slug":"reported-top-holder-group-share-benchmark-correlation-da78b050","name":"Reported Top-Holder Group Share — Benchmark Correlation","description":"Reported top-holder group share — Benchmark correlation: Benchmark correlation 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 benchmark correlation report.","url":"https://market.datapackvibe.com/x402/assistant-bx-token-top-group-correlation?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},"benchmarks":{"type":"array","items":{"type":"number","default":1,"maximum":1000000000000000000,"minimum":-1000000000000000000},"default":[10,20,30,40],"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_VFAr_h8ZiLwYVqE_gZXPd","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 statistical benchmark correlation between reported top-holder group share percentages and a set of user-supplied benchmark values across multiple token observations.","exampleAgentPrompt":"Can you calculate the benchmark correlation for our token's top-holder group share? We have 4 observations — group tokens of 400000, 440000, 400000, 440000 against circulating supplies of 1000000, 1100000, 1000000, 1100000 — and compare them against benchmarks of 10, 20, 30, and 40.","exampleUseCases":[{"title":"Token concentration vs market benchmark tracking","prompt":"I want to know how closely our token's top-holder group share correlates with our benchmark series [10, 20, 30, 40] — here are 4 observations: group tokens were 400000, 500000, 420000, 480000 out of circulating supplies of 1000000, 1200000, 1050000, 1150000."},{"title":"Due diligence on token holder distribution","prompt":"As part of my token due diligence, can you run a benchmark correlation on the top-holder group share using these observations: group_tokens [1000000, 1100000, 950000] vs circulating [5000000, 5200000, 4800000], benchmarked against [15, 18, 12]?"},{"title":"Monitoring top-holder concentration drift","prompt":"Check whether the top-holder group share for our project is drifting relative to our reference benchmarks — I have 5 data points: group tokens [200000, 210000, 205000, 215000, 220000] against circulating supplies [800000, 820000, 810000, 830000, 840000], with benchmarks [25, 26, 25.5, 26.5, 27]."}],"resultDescription":"Returns a bounded benchmark correlation report for the supplied top-holder group share observations versus the provided benchmark series. The report includes a deterministic correlation coefficient or a caller-threshold verdict indicating how closely the group share percentage tracks the benchmark values across observations.","failureModes":["Fewer than 2 rows supplied — minItems validation error","Fewer than 2 benchmark values supplied — minItems validation error","More than 200 rows or 200 benchmarks supplied — maxItems exceeded error","circulating_tokens is zero — exclusiveMinimum violated, division-by-zero risk","Mismatched array lengths between rows and benchmarks may produce unexpected correlation results","group_tokens or circulating_tokens exceed maximum allowed value (1e16) — schema validation error","Malformed JSON body returns 4xx error","Insufficient USDC balance or x402 payment failure results in 402 response"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, statistical correlation between a token's top-holder group share ratio and a set of benchmark reference values across multiple historical or snapshot observations. Prefer it over general-purpose statistics tools when working specifically with token holder concentration data and needing a bounded, low-cost ($0.01 USDC) report without requiring a live blockchain scan or real-time data feed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:48:04.937Z","isFirstParty":false,"canonicalSlug":"reported-top-holder-group-share-benchmark-correlation-da78b050"}