# RugShield Token Holder Distribution & Sybil Cluster Analyzer

> RugShield Token Holder Distribution & Sybil Cluster Analyzer is a paid API for AI agents from rugshield-402.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns top-10/top-50 holder distribution, LP lock percentage, and coordinated sybil cluster detection for a given Solana or Base token address.

## Facts

- Endpoint: POST https://rugshield-402.onrender.com/api/v1/tgm/holders?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rugshield-token-holder-distribution-sybil-cluster-analyzer-8d6a8e35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uxJ-i-7EycqycrRlSwXAW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rugshield-token-holder-distribution-sybil-cluster-analyzer-8d6a8e35 -d '<json body>'
```

Example prompt: Can you check the holder distribution and sybil risk for the Solana token at address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — I want to know if the top holders look coordinated and whether the LP is locked?

## When to prefer this

Use this endpoint when you need to evaluate the holder concentration risk and sybil/coordinated wallet activity for a specific Solana or Base token before trading or listing it. It is the right choice when you need LP lock data combined with holder distribution in a single call, especially for rug pull risk assessment workflows. Prefer this over general wallet profiling endpoints when the focus is token-level holder analysis rather than individual wallet history.

## Known failure modes

- Invalid or unsupported token address returns a 400 error
- Token not found on supported chains (Solana/Base) returns empty or null result
- Rate limiting or payment failure returns 402 or 429
- Newly launched tokens with minimal on-chain history may return sparse holder data
- LP lock data may be incomplete if the lock protocol is not indexed

## How this service works

Returns top-10/top-50 holder distribution, LP lock percentage, and coordinated sybil cluster detection for any Solana or Base token.

## Output

Returns a structured JSON response containing the top-10 and top-50 holder distribution (wallet addresses, percentages, USD values), LP lock percentage across known lock protocols, and identified coordinated sybil clusters (grouped wallet addresses with funding origin links and cluster risk scores).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token_address": {
   "type": "string",
   "description": "token address"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rugshield-token-holder-distribution-sybil-cluster-analyzer-8d6a8e35/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rugshield-402.onrender.com](https://www.zero.xyz/host/rugshield-402.onrender.com/llms.txt)
