Top-Level Structure

The data structure contains several main components:

{
    "minter": String,                         // The address that minted the token
    "token_address": String,                  // The token's address on Solana
    "token_mint_tx": String,                  // Transaction hash of the token mint
    "token_mint_time": ISO8601 DateTime,      // Timestamp of when the token was minted
    "sniper_analysis": Object,                // Detailed analysis of sniper activity
    "first_buyers_analysis": Object,          // Analysis of the initial buyers' behavior
    "top_10_holders_analysis": Object,        // Current top 10 token holders
    "dev_launched_tokens_in_24_hours": Number // Number of tokens launched by the same developer in 24h
}

Sniper Analysis

The sniper_analysis object contains information about automated buying activity that occurred shortly after token launch:

"sniper_analysis": {
    "sniper_count": Number,                  // Total number of identified sniper addresses
    "sniper_addresses": Array<String>,       // List of addresses identified as snipers
    "block_range_analysis": Array<Object>,   // Analysis of buying activity by block
    "median_time_since_mint": Number,        // Median time (seconds) between mint and buys
    "average_time_since_mint": Number,       // Average time (seconds) between mint and buys
    "sniper_confidence_score": Number,       // Confidence rating (0-100) of sniper activity
    "sniper_total_percentage": Number,       // Percentage of supply held by snipers
    "time_since_mint_analysis": Array<Object>, // Analysis of buys by time intervals
    "potential_frontrunning_detected": Boolean // Flag indicating potential frontrunning
}

Block Range Analysis

Each entry in block_range_analysis represents buying activity within a specific block:

{
    "addresses": Array<String>,        // Addresses that bought in this block
    "buy_count": Number,               // Number of buys in this block
    "timestamp": ISO8601 DateTime,     // Block timestamp
    "block_hash": String,              // Hash of the block
    "block_number": Number,            // Sequential block number from mint
    "supply_percentage": Number        // Percentage of total supply bought in this block
}

Time Since Mint Analysis

Each entry in time_since_mint_analysis shows buying activity within specific time windows after mint:

{
    "addresses": Array<String>,       // Addresses that bought in this time window
    "buy_count": Number,              // Number of buys in this time window
    "supply_percentage": Number,      // Percentage of total supply bought in this window
    "time_range_seconds": Number      // Time window in seconds from mint
}

First Buyers Analysis

The first_buyers_analysis provides detailed analysis of the initial buyers' behavior:

"first_buyers_analysis": {
    "timestamp": ISO8601 DateTime,               // When the analysis was performed
    "bundled_buyers_count": Number,              // Number of buyers potentially controlled by same entity
    "buyers_analyzed_count": Number,             // Total number of buyers analyzed
    "buys_in_same_block_count": Number,          // Number of buys occurring in the mint block
    "biggest_funder_sol_amount": Number,         // Amount of SOL from the largest funding source
    "biggest_funder_sol_address": String,        // Address of largest SOL funder
    "buyers_still_holding_count": Number,        // Number of initial buyers still holding
    "current_holding_percentage": Number,        // % of supply still held by initial buyers
    "distinct_funders_sol_count": Number,        // Number of unique SOL funding sources
    "snipers_still_holding_count": Number,       // Number of snipers still holding tokens
    "biggest_funder_token_address": String,      // Address of entity funding most token buys
    "buyers_transferred_out_count": Number,      // Number of buyers who sold/transferred tokens
    "current_percentage_per_buyer": Array<Object>, // Current holdings of each initial buyer
    "distinct_funders_token_count": Number,      // Number of distinct token funders
    "initially_acquired_percentage": Number,     // % of supply initially acquired by first buyers
    "top_5_buyers_bought_percentage": Number,    // % of supply bought by top 5 buyers
    "top_10_buyers_bought_percentage": Number,   // % of supply bought by top 10 buyers
    "top_20_buyers_bought_percentage": Number,   // % of supply bought by top 20 buyers
    "average_percentage_bundler_buyer": Number,  // Average % of supply per bundled buyer
    "bundled_percentage_supply_bought": Number,  // % of supply bought by bundled buyers
    "snipers_still_holding_percentage": Number,  // % of supply still held by snipers
    "biggest_funder_token_funded_count": Number, // Number of buys funded by biggest token funder
    "transfers_in_same_block_sol_count": Number, // SOL transfers in same block
    "bundled_buyers_still_holding_count": Number, // Number of bundled buyers still holding
    "bundled_current_holding_percentage": Number, // % of supply still held by bundled buyers
    "snipers_current_holding_percentage": Number, // % of supply still held by snipers
    "transfers_in_same_block_token_count": Number, // Token transfers in same block
    "bundled_percentage_supply_transfered": Number, // % of supply transferred by bundled buyers
    "biggest_funder_supply_percentage_token": Number, // % of supply funded by biggest funder
    "distributed_to_distinct_addresses_count": Number, // Number of unique final recipients
    "transferred_out_from_initially_acquired_percentage": Number, // % of initially acquired supply now transferred out
    "biggest_funder_sol_funded_count": Number   // Number of buys funded by biggest SOL funder
}

Current Percentage Per Buyer

Each entry in current_percentage_per_buyer shows the current status of an initial buyer:

{
    "address": String,                // Buyer's address
    "balance": Number,                // Current token balance
    "is_sniper": Boolean,             // Whether classified as a sniper
    "is_bundler": Boolean,            // Whether part of a bundled entity
    "supply_percentage": Number       // % of total supply currently held
}

Top 10 Holders Analysis

The top_10_holders_analysis shows the current top token holders:

"top_10_holders_analysis": {
    "topHolders": Array<Object>,      // List of top 10 holders
    "totalSupply": Number,            // Current total supply
    "percentageHeldByTop10": Number   // % of supply held by top 10
}

Top Holders

Each entry in topHolders:

{
    "amount": Number,                // Token amount held
    "percentage": Number,            // % of total supply
    "ownerAddress": String,          // Wallet address of owner
    "accountAddress": String         // Token account address
}

Security and Market Analysis Indicators

Several metrics in this data structure can be used to evaluate token security and market dynamics:

Sniper Activity: High sniper_confidence_score or sniper_total_percentage may indicate potential market manipulation.
Ownership Concentration: High percentageHeldByTop10 could indicate centralized control.
Bundled Buyers: High bundled_buyers_count may suggest coordinated buying.
Developer Activity: High dev_launched_tokens_in_24_hours might indicate a serial token launcher.
Early Buying Patterns: Analysis of block_range_analysis and time_since_mint_analysis can reveal unusual trading patterns.
Initial Distribution: initially_acquired_percentage shows how much supply was captured immediately.
Retention Rates: Compare buyers_still_holding_count against buyers_analyzed_count to assess holder confidence.
Frontrunning: The potential_frontrunning_detected flag indicates possible miner-extracted value.