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.
- Initial Analysis: Captured within the critical first hours after token minting. This type of field is subject to the 10-hour window constraint.
- 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 highbundled_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
andcurrent_holding_percentage
: Shows significant selling activity by initial buyers