atomic-holder-analysis

Analyzes Solana token holder distribution with Gini coefficient, concentration metrics, and Sybil detection heuristics.

15|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/nirholas/atomic --skill atomic-holder-analysis-nirholas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atomic-holder-analysis
Source: https://github.com/nirholas/atomic/tree/main/skills/holder-analysis
Command: npx skills add https://github.com/nirholas/atomic --skill atomic-holder-analysis-nirholas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before running an airdrop, distribution, or governance action on a pump.fun or Solana SPL token, you need to know who actually holds the supply — whether it is concentrated in a few whales, broadly distributed, or flooded with Sybil wallets. Manually inspecting thousands of token accounts via RPC is impractical, and raw holder lists reveal nothing about distribution quality. ## Core Features & Use Cases - Distribution Metrics: Computes holder count, top-N concentration (top 1/5/10/25/50/100), Gini coefficient, and an order-of-magnitude balance histogram for any SPL or Token-2022 mint. - Sybil Signal Detection: Flags balance clustering (many wallets with near-identical balances) and suspiciously flat top-10 distributions that indicate deliberate wallet splitting. - Use Case: Before running a token distribution, run the analyzer on your coin's mint to check whether the holder base is large and organic enough to justify the spend, then cross-check suspect wallets with a funding-provenance audit to filter pump-seeded Sybil clusters. ## Quick Start Ask the AI to analyze the holder distribution of your token mint address and report the Gini coefficient, top-10 concentration, and any Sybil signals.

Frequently Asked Questions about atomic-holder-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze holder distribution of a Solana token?▼

Run the analyze-holders script with the mint address using npx tsx tools/analyze-holders.ts <mint>. It queries token accounts via RPC and reports holder count, top-N concentration, Gini coefficient, a balance histogram, and the top 10 holder wallets.

How to detect Sybil wallets in a token holder list?▼

The script flags two heuristic signals: balance clustering where 10% or more of holders share near-identical balances, and a suspiciously flat top-10 owning under 15% of supply across 50+ holders. Cross-check flagged wallets with a funding-provenance audit for stronger evidence.

What is a normal Gini coefficient for a pump.fun coin?▼

Pump.fun coins shortly after graduation typically sit between 0.7 and 0.85. Values below 0.5 with more than 100 holders suggest Sybil activity or a prior airdrop, while values above 0.95 indicate a single wallet controls nearly all supply.

Does holder analysis work with public Solana RPC endpoints?▼

Public RPC works for mints with under roughly 500 holders. For 500 to 5000 holders a paid RPC like Helius or Triton is needed, and beyond 5000 holders an indexer such as Solana FM or Birdeye is recommended to avoid timeouts.

What are the limitations of snapshot-based holder analysis?▼

The snapshot only includes active token accounts with non-zero balances, so closed accounts and historical holders are excluded. It provides no off-chain identity for wallets, no USD weighting, and its Sybil heuristics can be evaded by varying balance sizes.