Holders

The Holders Widget displays real-time token distribution data, allowing users to track wallet concentrations, identify whales, and assess the overall decentralization of a project.

It visualizes top-holder dominance, filters wallets by category, and exports data for external analysis, providing full transparency over token ownership after launch or graduation.

---

Breakdown of Elements

• Header Section: Displays the widget title (Holders) along with token name, ticker, and network type (EVM or other). Includes Total Supply, Market Cap, and Top 10 Share (the combined % held by the ten largest wallets).

• Contract Address: Shows the verified on-chain contract address for direct access to the token’s smart contract.

• Pie Chart (Top 5): Visualizes token distribution among the top 5 holders versus all others, helps gauge decentralization and whale influence.

• Top Holder List: Ranked table showing each address’s balance, % of total supply, USD value, and transaction count.

• Search Bar: Lets users search any wallet, exchange, team wallet, or whale address to view their holdings instantly.

• Sorting Dropdown: Allows sorting by % of supply, balance, or alphabetical order to quickly analyse wallet tiers.

• Filter Tabs:

  • All: Displays every address holding the token.

  • Whales ≥ 1%: Highlights large holders who could impact market movement.

  • Dolphins (0.1–1%) and Shrimps ≤ 0.1%: Show mid-tier and small retail wallets.

  
• Hide Contracts / Burn / Dev Toggles: Exclude contract addresses, burned wallets, or developer wallets from the chart for cleaner analysis.

• Export Buttons (CSV / JSON): Enable data export for spreadsheets or integration with analytics dashboards.