# RugShield Holder Cluster Map

> RugShield Holder Cluster Map is a paid API for AI agents from rugshield-402.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Analyzes on-chain funding origins for the top 50 token holders to detect sybil clusters, developer dump risks, and wash-trading rings.

## Facts

- Endpoint: POST https://rugshield-402.onrender.com/v1/audit/holder-cluster-map?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rugshield-holder-cluster-map-e860318a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_exulfwzhZ8pQ_VQcBZqcE

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-holder-cluster-map-e860318a -d '<json body>'
```

Example prompt: Can you run a holder cluster map audit on the top 50 holders of this Base token at 0x1234abcd... to check whether any of them are sybil wallets, funded from the same source, or part of a wash-trading ring?

## When to prefer this

Use this endpoint when you need to analyze the actual funding origins and wallet relationships among a token's top holders — specifically to detect sybil clusters, wash-trading coordination, or dev dump risk. Prefer this over simple holder distribution tools when you need graph-level cluster analysis rather than just concentration metrics, and when the token is on Base or a supported EVM chain.

## Known failure modes

- Invalid or non-existent token contract address returns an error
- Token has fewer than the expected number of on-chain holders, limiting cluster analysis
- RPC or indexer timeouts when tracing deep funding origin chains
- Insufficient on-chain history for newly deployed tokens
- Payment failure results in 402 response before analysis begins

## How this service works

Analyzes on-chain funding origins for the top 50 token holders to detect sybil clusters, dev dump risks, and wash-trading rings.

## Output

Returns a holder cluster map showing funding origin relationships among the top 50 token holders, including identified sybil clusters (groups of wallets funded from common sources), a developer dump risk assessment, wash-trading ring indicators, and a graph of wallet interconnections that reveal coordinated behavior.

## 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-holder-cluster-map-e860318a/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)
