{"uid":"cap_Q2rl5sWIBCS1k3t1tWmcY","slug":"signalharness-token-holder-concentration-analyzer-757ed262","name":"SignalHarness Token Holder Concentration Analyzer","description":"Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.","url":"https://signalharness.ai/api/agent/services/token_holder_concentration/invoke","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token_holder_request":{"type":"string","maxLength":65536,"minLength":2}}},"responseSchema":{"type":"json","example":{"replay":false,"result":{"warnings":["Incomplete holder sets produce incomplete concentration metrics."],"service_id":"token_holder_concentration","evidence_scope":"caller_supplied_data","holder_concentration":"{\"hhi\":\"0.52\",\"holder_count\":2,\"top_10_share_percent\":\"100\",\"top_1_share_percent\":\"60\",\"total_atomic\":\"100\"}"},"status":"succeeded","receipt":{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","usage":[],"status":"succeeded","network":"eip155:8453","artifacts":[],"endedAtMs":0,"latencyMs":0,"paymentId":"example-payment","receiptId":"example-receipt","requestId":"example-request","serviceId":"token_holder_concentration","executionId":"example-execution","startedAtMs":0,"amountAtomic":"10000","resultSha256":"41774a6931df6a07e22e7bd670b13b087965106564f11f80308f2889255f7c7d","serviceVersion":"1.0.0","settlementReference":"0x0000000000000000000000000000000000000000000000000000000000000000"},"artifacts":[],"requestId":"example-request","executionId":"example-execution"}},"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_PBwFzBbEiR27nsqiNaz2h","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":"Analyzes the concentration of token holders for a given cryptocurrency token, returning a concentration assessment with supporting evidence.","exampleAgentPrompt":"Can you check the token holder concentration for UNI (Uniswap token) and tell me whether the supply is mostly held by whales or is reasonably distributed?","exampleUseCases":[{"title":"DeFi token due diligence check","prompt":"Before I invest, can you analyze the holder concentration for the token at address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Base and tell me if a few wallets control most of the supply?"},{"title":"Rug pull risk screening","prompt":"I'm vetting a new DeFi project — can you check whether the token PEPE has highly concentrated holders that could signal a rug pull risk?"},{"title":"Portfolio risk assessment for concentrated tokens","prompt":"I hold several altcoins and want to know which ones have dangerous whale concentration. Can you analyze the holder concentration for SHIB and give me a summary of how centralized the ownership is?"}],"resultDescription":"Returns a JSON object containing a holder_concentration assessment (a label or score describing how concentrated token holders are), an evidence_scope field indicating the basis of the analysis (caller-supplied data), any warnings generated during analysis, and a signed receipt with payment details, execution metadata, and a SHA-256 result hash for auditability.","failureModes":["Insufficient or malformed token_holder_request string returns an error or low-confidence result","Token not found or unrecognized may yield warnings with incomplete concentration data","Ambiguous token names (e.g. common ticker symbols) may produce evidence_scope limited to caller-supplied data with no on-chain lookup","Payment failure or insufficient USDC balance prevents execution","Overly long input exceeding 65,536 characters will be rejected"],"whenToPreferThis":"Choose this endpoint when you need a fast, agent-native, pay-per-call assessment of token holder concentration without setting up a full blockchain data pipeline. It is especially useful for DeFi due diligence, rug pull screening, or decentralization audits where you need a structured concentration verdict with an auditable receipt. Prefer it over raw on-chain data tools when you want an interpreted result rather than raw holder lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:07:09.100Z","isFirstParty":false}