Who holds this token — and can they dump on you?

Concentration is a top rug predictor: if one non-pool wallet holds most of the float, it can dump and drain everyone. This enumerates every holder from the issuer's trustlines, separates the AMM pool (that's liquidity, not a whale), and flags single-wallet dump risk. Large tokens honestly return unknown_large instead of guessing from a partial scan.

MCP tool: token_holders Price: $0.008 / call

Parameters

Param	Description
`issuer`	XRPL issuer address (r...)
`currency`	3-char code or 40-char hex

Example

Call (MCP tools/call arguments):

{
  "issuer": "rJtmr5fC94YwD3Q7NNeKixcuXFKM63eeLn",
  "currency": "537761726D585250000000000000000000000000"
}

Result:

{
  "ok": true,
  "holder_count": 39,
  "holders_complete": true,
  "top_holder_pct": 0.1917,
  "top10_pct": 0.8433,
  "amm_pool_pct": 0.8686,
  "concentration": "distributed",
  "reasons": [
    "39 non-pool holders",
    "top holder controls 19.2% of circulating (non-pool) supply",
    "AMM pool holds 86.9% of total supply (liquidity, not counted as a whale)",
    "no single wallet dominates"
  ]
}

FAQ

How do I check XRPL token holder concentration?

Every holder of an XRP Ledger token has a trustline to the issuer, so the full holder set and balances are on-chain. This tool paginates them, excludes the AMM pool (which legitimately holds liquidity), and reports the top-1 and top-10 share of circulating supply.

Why exclude the AMM pool from concentration?

A token's AMM pool account holds a large share of supply as liquidity — that's healthy, not a whale. Counting it would make every token look dangerously concentrated. Concentration is measured on non-pool holders.

Connect via MCP at https://cerberusindex.com/mcp — see the quickstart. Payment is automatic for x402-aware clients. Verdicts are informational risk signals, not financial advice.