Get detailed early holder analysis for a token

GET https://api.webacy.com/holder-analysis/{address}

Analyzes token holders, buying patterns, and detects suspicious activity such as sniper bots and coordinated buys. This endpoint provides comprehensive insights into token ownership distribution, early investor behavior, and potential risk factors. Data reflects initial 10-hours window after mint.

This endpoint returns critical early token analysis such as bundling, top holder distributions, snipers, and more.

For a detailed overview of bundling and the return, start here.

For a detailed overview of sniping and the return, start here.

❗️

Premium Endpoint

Your demo key will not have default access to this endpoint.

Contact a Webacy team member to upgrade your key and get access to this API.

📘

10-Hour Window Constraint

Some fields in the return are specifically meant to track and analyze the behavior of early token buyers. After the initial critical window of 10 hours after mint, the analysis will pause, capturing a snapshot of token dynamics at the time of inception.

Other fields in the data return offer real-time tracking, continuously updating metrics that monitor initial buyer behavior regardless of token age. This is useful, for example, to understand metrics such as how much of the token is still held by bundlers or snipers days or weeks after launch.

There are two types of fields in the data return of this endpoint.

1. Initial Analysis: Captured within the critical first hours after token minting. This type of field is subject to the 10-hour window constraint.
2. Real-Time Tracking: Continuously updated metrics that monitor initial buyer behavior regardless of token age.

Initial Analysis Fields

These fields are captured during the initial analysis phase (subject to the 10-hour window constraint):

Field	Description	Example
initially_acquired_percentage	Percentage of total supply acquired by first buyers	77.2%
buyers_analyzed_count	Number of first buyers analyzed	15
top_10_buyers_bought_percentage	Percentage bought by top 10 buyers	68.5%
top_5_buyers_bought_percentage	Percentage bought by top 5 buyers	52.1%
top_20_buyers_bought_percentage	Percentage bought by top 20 buyers	75.8%
bundled_percentage_supply_bought	Percentage bought in the same block	45.2%
buys_in_same_block_count	Number of buys in the same block	8
average_percentage_bundler_buyer	Average percentage held by bundler buyers	15.3%
buyers_transferred_out_count	Number of buyers who transferred tokens out	3
distributed_to_distinct_addresses_count	Number of distinct receiving addresses	42
transferred_out_from_initially_acquired_percentage	Percentage transferred by first buyers	8.9%
bundled_buyers_count	Number of buyers in the same block	3
timestamp	Time when analysis data was collected	"2025-03-21T13:15:22.000Z"

Additionally, the analysis includes TransferTokenStats and TransferSolStats fields that provide further details about funding patterns.

Real-Time Tracking Fields

These fields are continuously updated regardless of token age, providing ongoing visibility into first buyer behavior:

Field	Description	Example
current_holding_percentage	Percentage currently held by all first buyers	68.3%
bundled_current_holding_percentage	Percentage currently held by bundled buyers	45.2%
buyers_still_holding_count	Number of first buyers still holding tokens	12
bundled_buyers_still_holding_count	Number of bundled buyers still holding	3
current_percentage_per_buyer	Array of detailed per-buyer holding data	see below

PercentagePerBuyer Object Structure

The current_percentage_per_buyer field contains an array of objects with the following structure:

interface PercentagePerBuyer {
  address: string;            // Wallet address of the buyer
  balance: number;            // Current token balance
  supply_percentage: number;  // Percentage of total supply currently held
  is_bundler: boolean;        // Whether this buyer is part of a bundled buying group
}

example:

[
  {
    "address": "ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS",
    "balance": 189200000,
    "supply_percentage": 18.92,
    "is_bundler": true
  },
  {
    "address": "o7RY6P2vQMuGSu1TrLM81weuzgDjaCRTXYRaXJwWcvc",
    "balance": 127600000,
    "supply_percentage": 12.76,
    "is_bundler": true
  }
]

Interpreting Results

For specific details on understanding how to interpret bundling and sniping results, visit their respective pages.

Examples of how these metrics provide valuable insights for assessing token health:

• High current_holding_percentage with high bundled_current_holding_percentage: Suggests concentrated ownership by coordinated buyers, a potential red flag for manipulation
• Low buyers_still_holding_count relative to initial buyer count: Indicates early buyers have sold their positions, possibly "dumping" on later buyers
• Large difference between initially_acquired_percentage and current_holding_percentage: Shows significant selling activity by initial buyers