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):

FieldDescriptionExample
initially_acquired_percentagePercentage of total supply acquired by first buyers77.2%
buyers_analyzed_countNumber of first buyers analyzed15
top_10_buyers_bought_percentagePercentage bought by top 10 buyers68.5%
top_5_buyers_bought_percentagePercentage bought by top 5 buyers52.1%
top_20_buyers_bought_percentagePercentage bought by top 20 buyers75.8%
bundled_percentage_supply_boughtPercentage bought in the same block45.2%
buys_in_same_block_countNumber of buys in the same block8
average_percentage_bundler_buyerAverage percentage held by bundler buyers15.3%
buyers_transferred_out_countNumber of buyers who transferred tokens out3
distributed_to_distinct_addresses_countNumber of distinct receiving addresses42
transferred_out_from_initially_acquired_percentagePercentage transferred by first buyers8.9%
bundled_buyers_countNumber of buyers in the same block3
timestampTime 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:

FieldDescriptionExample
current_holding_percentagePercentage currently held by all first buyers68.3%
bundled_current_holding_percentagePercentage currently held by bundled buyers45.2%
buyers_still_holding_countNumber of first buyers still holding tokens12
bundled_buyers_still_holding_countNumber of bundled buyers still holding3
current_percentage_per_buyerArray of detailed per-buyer holding datasee 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
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!