> ## Documentation Index > Fetch the complete documentation index at: https://docs.webacy.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Detailed Early Holder Analysis for a Token > 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. **Supported Chains:** - **Solana** (`sol`): Data reflects initial 10-hours window after mint with sniper detection - **EVM chains** (`eth`, `bsc`, `pol`, `arb`, `opt`, `base`): Top holders and sniper detection - **Stellar** (`stellar`): Address must be in `CODE:ISSUER` format - **Sui** (`sui`): First buyers analysis with bundler detection - **Hedera** (`hedera`): Accepts native `0.0.X` format (HTS token ID) or EVM address format. Includes token admin keys analysis (admin, freeze, wipe, pause, supply, KYC, fee schedule keys), custom fee schedules, and pause status. Sniper/bundling analysis is excluded (Hedera has deterministic transaction ordering, no MEV). ## OpenAPI ````yaml GET /holder-analysis/{address} openapi: 3.0.1 info: title: Risk Score API description: API definition for Webacy Risk Scores version: 1.2.0 servers: - url: https://api.webacy.com description: Webacy Risk Score API (Production) - url: https://api-development.webacy.com description: Webacy Risk Score API (Development) - url: http://0.0.0.0:3030/api/v1/risk-score description: Webacy Risk Score API - Local security: - api_key: [] tags: - name: Threat Risks description: Analyze addresses for security threats and malicious activity - name: Sanction Checks description: Check addresses against OFAC and other sanction lists - name: Approval Risks description: Analyze token approvals and associated risks - name: Transaction Risks description: Assess risk details for blockchain transactions - name: Exposure Risk description: Understand risk profile and exposure of addresses - name: Contract Risk description: Real-time smart contract security analysis - name: URL Risks description: Analyze URLs for phishing and security threats - name: API Usage description: Monitor and manage API consumption - name: Holder Analysis description: Token holder distribution and sniper detection - name: Address Poisoning description: Detect address poisoning attack patterns - name: Token Analysis description: Comprehensive token security and market analysis - name: Pool Analysis description: Liquidity pool data and analysis - name: Transaction Scanning description: Scan and simulate transactions for risks - name: trading-lite description: Lightweight trading risk assessment - name: RWA & Pegged Tokens description: >- Real-world asset and pegged-token analytics (supply flows, mint/burn velocity) - name: Vault Risk v3 description: >- Webacy-native v3 vault risk surface — composite grade, categories, coverage, and the framework taxonomy (RFC-019). - name: RWA Risk v3 description: >- Webacy-native v3 RWA / stablecoin risk surface — composite grade, structural-health criteria, and batch (RFC-019). paths: /holder-analysis/{address}: get: tags: - Holder Analysis summary: Get detailed early holder analysis for a token description: >- 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. **Supported Chains:** - **Solana** (`sol`): Data reflects initial 10-hours window after mint with sniper detection - **EVM chains** (`eth`, `bsc`, `pol`, `arb`, `opt`, `base`): Top holders and sniper detection - **Stellar** (`stellar`): Address must be in `CODE:ISSUER` format - **Sui** (`sui`): First buyers analysis with bundler detection - **Hedera** (`hedera`): Accepts native `0.0.X` format (HTS token ID) or EVM address format. Includes token admin keys analysis (admin, freeze, wipe, pause, supply, KYC, fee schedule keys), custom fee schedules, and pause status. Sniper/bundling analysis is excluded (Hedera has deterministic transaction ordering, no MEV). operationId: getHolderAnalysis parameters: - name: address in: path required: true description: >- Token contract address. For Solana: mint address. For EVM chains: ERC-20 token contract address. For Stellar: 'CODE:ISSUER' format. For Hedera: HTS token ID in '0.0.X' native format (e.g., '0.0.8144307') or EVM address format. schema: type: string examples: solana: summary: Solana USDC value: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v ethereum: summary: Ethereum USDC value: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' base: summary: Base USDC value: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' bsc: summary: BSC USDT value: '0x55d398326f99059fF775485246999027B3197955' polygon: summary: Polygon USDC value: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174' stellar: summary: Stellar USDC value: USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN hedera: summary: Hedera HTS Token value: 0.0.8144307 - name: chain in: query required: true description: >- Blockchain network to analyze. Supported chains: sol (Solana), eth (Ethereum), bsc (BSC), pol (Polygon), arb (Arbitrum), opt (Optimism), base (Base), stellar (Stellar), sui (Sui), hedera (Hedera) schema: type: string enum: - sol - eth - bsc - pol - arb - opt - base - stellar - sui - hedera - name: useCache in: query required: false description: 'Whether to use cached data if available (default: true)' schema: type: boolean default: true - name: refetchData in: query required: false description: >- Whether to schedule a background refresh of analysis (default: false) schema: type: boolean default: false - name: maxHolders in: query required: false description: 'Maximum number of holders to analyze (default: 10000)' schema: type: integer default: 10000 maximum: 50000 responses: '200': description: Successful operation content: application/json: schema: $ref: '#/components/schemas/HolderAnalysisResult' examples: solana: summary: Solana token analysis description: Example response for Solana USDC token value: token_address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v metadata: name: USD Coin symbol: USDC ethereum: summary: Ethereum token analysis description: Example response for Ethereum USDC token value: token_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' metadata: name: USD Coin symbol: USDC base: summary: Base token analysis description: Example response for Base USDC token value: token_address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' metadata: name: USD Coin symbol: USDC stellar: summary: Stellar USDC (no early holder analysis) description: >- Example response for Stellar USDC token - established token without early holder analysis value: token_address: >- USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN top_10_holders_analysis: totalSupply: '2453214652377174' percentageHeldByTop10: 71.3 totalHoldersCount: 577705 topHolders: - ownerAddress: >- GC5LF63GRVIT5ZXXCXLPI3RX2YXKJQFZVBSAO6AUELN3YIMSWPD6Z6FH amount: '439852177936622' percentage: 17.93 - ownerAddress: >- GAPV2C4BTHXPL2IVYDXJ5PUU7Q3LAXU7OAQDP7KVYHLCNM2JTAJNOQQI amount: '326821613300000' percentage: 13.32 - ownerAddress: >- GAFK7XFZHMLSNV7OJTBO7BAIZA66X6QIBV5RMZZYXK4Q7ZSO52J5C3WQ amount: '315003695542218' percentage: 12.84 total_holders_count: 577705 metadata: name: '' symbol: USDC decimals: 7 stellar_with_first_buyers: summary: Stellar token with early holder analysis description: >- Example response for a newer Stellar token with first buyers analysis value: token_address: >- WSamsung:GAFKQXZYW32INZMX3N4CPB73P3ZYTPHYEZF2HYBHVL6LFPSLLOWPTJVS total_holders_count: 19 token_mint_time: '2025-11-18T17:44:33.000Z' first_buyers_analysis: initially_acquired_percentage: 100 buyers_analyzed_count: 50 unique_buyers_count: 50 buyer_segmentation_limited: false top_5_buyers_bought_percentage: 86.99 top_10_buyers_bought_percentage: 90.37 top_20_buyers_bought_percentage: 95.25 distributed_to_distinct_addresses_count: 50 timestamp: '2025-12-09T21:08:00.709Z' current_holding_percentage: 25.09 buyers_still_holding_count: 9 buyers_transferred_out_count: 41 transferred_out_from_initially_acquired_percentage: 74.91 current_percentage_per_buyer: - address: >- GBHA5DSF32QSWFKMTXRQKTNAUV25DII6PVFUMIFL75QKQDL357BE2TXC balance: 88000000000 supply_percentage: 5.65 - address: >- GC6R6KPF3P34ISZBPDPTCJRONLILUA2YSIIJ4SYFIXWDMKJK7HLI7HL7 balance: 120080000000 supply_percentage: 7.71 dev_holdings_percentage: null bundled_buyers_count: null bundled_current_holding_percentage: null bundled_buyers_still_holding_count: null average_percentage_bundler_buyer: null snipers_current_holding_percentage: null snipers_still_holding_count: null snipers_still_holding_percentage: null top_10_holders_analysis: totalSupply: '1557599999965' percentageHeldByTop10: 57.58 totalHoldersCount: 19 topHolders: - ownerAddress: >- GAGXYKAPZ6BDXY6A2O5VUEZBG2GSLKD23QVC3HBWJVINKN6UQW3DIUYS amount: '184000000000' percentage: 11.81 - ownerAddress: >- GDNYLNGKBRGB326YVEENK7RZ6VQB2ZDPPKTZDHSSWPHP7GHZQ47B2PYU amount: '120080000000' percentage: 7.71 - ownerAddress: >- GC6R6KPF3P34ISZBPDPTCJRONLILUA2YSIIJ4SYFIXWDMKJK7HLI7HL7 amount: '120080000000' percentage: 7.71 metadata: name: WSamsung symbol: WSamsung decimals: 7 '400': description: Invalid address format content: application/json: example: message: Invalid address format for the specified chain '401': $ref: '#/components/responses/UnauthorizedError' '404': description: Analysis not available or token not found content: application/json: example: message: Holders analysis not available for this token '429': description: Too many requests content: application/json: example: message: Rate limit exceeded security: - api_key: [] components: schemas: HolderAnalysisResult: type: object properties: token_address: type: string description: Address of the analyzed token example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v token_mint_tx: type: string description: Transaction hash of token mint example: >- 4JqaQUsu5mRADKcHYCL9X1VNDEfZfTmbsXCTSuSJpBXgxbZGQYTHBvzdrHj11NfcDDVEXbELpnEZYVWfpnJ1mgU7 token_mint_time: type: string format: date-time description: Timestamp when token was minted example: '2023-03-21T13:00:22.000Z' minter: type: string description: Address of token minter example: FRgKuRNLRxTzChEKYgFZc5UiEBvZrBYNcRdmbEbXeS17 first_buyers_analysis: $ref: '#/components/schemas/FirstBuyersAnalysisResult' top_10_holders_analysis: $ref: '#/components/schemas/OwnershipDistribution' dev_launched_tokens_in_24_hours: type: integer description: Number of tokens launched by the same developer in 24 hours example: 3 sniper_analysis: $ref: '#/components/schemas/SniperAnalysisResult' metadata: $ref: '#/components/schemas/TokenMetadata' description: >- Token metadata information including name, symbol, links, and other details FirstBuyersAnalysisResult: type: object properties: initially_acquired_percentage: type: number description: Percentage of total supply acquired by first buyers example: 82.4 buyers_analyzed_count: type: integer description: Number of first buyers analyzed example: 20 top_10_buyers_bought_percentage: type: number description: Percentage of total supply bought by top 10 buyers example: 75.3 top_5_buyers_bought_percentage: type: number description: Percentage of total supply bought by top 5 buyers example: 68.2 top_20_buyers_bought_percentage: type: number description: Percentage of total supply bought by top 20 buyers example: 81.7 bundled_percentage_supply_bought: type: number description: Percentage of supply bought in coordinated buys example: 62.5 buys_in_same_block_count: type: integer description: Number of buys in the same block (coordinated buys) example: 12 current_holding_percentage: type: number description: Percentage of total supply currently held by first buyers example: 65.7 bundled_current_holding_percentage: type: number description: Percentage of total supply currently held by bundled first buyers example: 58.4 buyers_still_holding_count: type: integer description: Number of first buyers still holding tokens example: 15 bundled_buyers_still_holding_count: type: integer nullable: true description: >- Number of bundled first buyers still holding tokens (null if data unavailable) example: 8 average_percentage_bundler_buyer: type: number nullable: true description: >- Average percentage of total supply held per bundler buyer (null if data unavailable) example: 5.8 buyers_transferred_out_count: type: integer description: Number of first buyers who transferred tokens out example: 8 distributed_to_distinct_addresses_count: type: integer description: Number of distinct addresses receiving tokens from first buyers example: 24 transferred_out_from_initially_acquired_percentage: type: number nullable: true description: >- Percentage of initially acquired supply transferred out (null if data unavailable) example: 16.7 bundled_buyers_count: type: integer nullable: true description: Number of buyers in bundled buys (null if data unavailable) example: 10 all_bundled_addresses: type: array description: >- Complete list of ALL bundled addresses detected (including those who sold out). Returns empty array when no bundling detected. items: type: string example: - '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' - '0x1234567890abcdef1234567890abcdef12345678' - '0xabcdefabcdefabcdefabcdefabcdefabcdefabcd' distinct_funders_sol_count: type: integer description: Number of distinct SOL funders for first buyers example: 3 biggest_funder_sol_amount: type: number description: Amount of SOL from biggest funder example: 25.8 biggest_funder_sol_funded_count: type: integer description: Number of addresses funded by biggest SOL funder example: 8 biggest_funder_sol_address: type: string description: Address of biggest SOL funder example: 8xJZ1hfsjTmTCCNxB6xNv66vvsTC5L11C7YomPdBkMYk transfers_in_same_block_sol_count: type: integer description: Number of SOL transfers in same block example: 10 distinct_funders_token_count: type: integer description: Number of distinct token funders example: 2 biggest_funder_supply_percentage_token: type: number description: Percentage of supply from biggest token funder example: 48.5 biggest_funder_token_address: type: string description: Address of biggest token funder example: Fy57GXAqmnYvYGVXtcMXUBm3UD9XxQbW2WxEMbFqiQHi transfers_in_same_block_token_count: type: integer description: Number of token transfers in same block example: 12 biggest_funder_token_funded_count: type: integer description: Number of addresses funded by biggest token funder example: 9 timestamp: type: string format: date-time description: When this analysis was performed example: '2023-03-21T13:15:22.000Z' current_percentage_per_buyer: type: array description: Current percentage of supply held by each initial buyer items: type: object properties: address: type: string description: Buyer's wallet address example: 0x123...abc balance: type: number description: Current token balance example: 1000000 supply_percentage: type: number description: Percentage of total supply held example: 5.2 is_bundler: type: boolean description: Whether this buyer participated in bundled buys example: false snipers_current_holding_percentage: type: number nullable: true description: >- Current percentage of supply held by all snipers (null if data unavailable) example: 12.5 snipers_still_holding_count: type: integer nullable: true description: Number of snipers still holding tokens (null if data unavailable) example: 3 snipers_still_holding_percentage: type: number nullable: true description: >- Percentage of supply held by snipers who still have tokens (null if data unavailable) example: 10.2 dev_holdings_percentage: type: number nullable: true description: >- Percentage of total supply currently held by the development team (currently tracks deployer/minter only, null if deployer address unknown or data unavailable) example: 15.5 OwnershipDistribution: type: object properties: totalSupply: type: number description: Total supply of the token example: 10000000 percentageHeldByTop10: type: number description: Percentage of supply held by top 10 holders example: 87.5 expiresAt: type: number description: Timestamp (in milliseconds) when this data expires example: 1741284889983 topHolders: type: array description: Details of top 10 holders items: $ref: '#/components/schemas/TokenHolder' example: totalSupply: 10000000 percentageHeldByTop10: 87.5 expiresAt: 1741284889983 topHolders: - accountAddress: TokenAccountAddress123 ownerAddress: ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS alias: Raydium AMM amount: 1000000 percentage: 12.34 label_info: label_type: dex label_name: Raydium AMM label_subtype: amm - accountAddress: TokenAccountAddress456 ownerAddress: BRwMfwzJG3aQpr9JZPk5GbZkZSfVW4vBqqTDjykn3bgB alias: Jupiter Exchange amount: 750000 percentage: 7.5 label_info: label_type: dex label_name: Jupiter Exchange label_subtype: swap SniperAnalysisResult: type: object properties: sniper_addresses: type: array description: List of addresses identified as potential snipers items: type: string example: - ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS - o7RY6P2vQMuGSu1TrLM81weuzgDjaCRTXYRaXJwWcvc sniper_count: type: integer description: Number of identified sniper addresses example: 5 sniper_total_percentage: type: number description: Total percentage of token supply acquired by snipers example: 77.18 block_range_analysis: type: array description: Block-by-block breakdown of trading activity items: type: object properties: block_hash: type: string example: 917TtwH3X6NLwAtWsWLPejRBw9b7W1cD1NadihRNYZZY timestamp: type: string format: date-time example: '2023-03-21T13:10:22.000Z' buy_count: type: integer example: 3 block_number: type: integer example: 1 addresses: type: array items: type: string example: - ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS supply_percentage: type: number example: 71.56 time_since_mint_analysis: type: array description: Trading activity analyzed by time intervals items: type: object properties: time_range_seconds: type: integer example: 10 buy_count: type: integer example: 16 addresses: type: array items: type: string supply_percentage: type: number example: 72.81 average_time_since_mint: type: number description: Average time (seconds) of buys after mint example: 224.36 median_time_since_mint: type: number description: Median time (seconds) of buys after mint example: 150 potential_frontrunning_detected: type: boolean description: Whether potential frontrunning was identified example: true sniper_confidence_score: type: integer description: Overall score (0-100) indicating confidence in sniper activity example: 46 TokenMetadata: type: object properties: name: type: string description: Name of the token example: USD Coin symbol: type: string description: Symbol of the token example: USDC contract_address: type: string description: Contract address of the token example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' chain: type: string description: The blockchain network where the token resides example: eth other_chains: type: array description: List of other chains where this token is deployed items: type: object properties: chain: type: string description: Network identifier example: pol contract_address: type: string description: Token address on this network example: '0x2791bca1f2de4661ed88a30c99a7a9449aa84174' decimals: type: integer description: Number of decimal places example: 6 links: type: object description: External resources related to the token properties: homepage: type: string description: Project website URL example: https://www.circle.com/en/usdc github: type: array description: GitHub repository URLs items: type: string example: - https://github.com/centrehq twitter: type: string description: Twitter profile URL example: https://twitter.com/circle telegram: type: string description: Telegram channel URL example: https://t.me/circle_issuer categories: type: array description: Token categories or tags items: type: string example: - stablecoin - asset-backed-stablecoin - usd-stablecoin image_url: type: string description: URL to token logo image example: >- https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png created_at: type: string description: Token creation date example: '2018-09-26' last_updated: type: string description: Last time this data was updated format: date-time example: '2023-06-15T12:34:56Z' required: - name - symbol - contract_address - chain - other_chains - categories - last_updated TokenHolder: type: object required: - ownerAddress - amount properties: accountAddress: type: string description: Token account address example: TokenAccountAddress123 ownerAddress: type: string description: Wallet address of the token holder example: ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS alias: type: string description: >- Human-readable label for the address (e.g., exchange or protocol name) example: Raydium AMM amount: type: number description: Token balance example: 1000000 percentage: type: number description: Percentage of total supply held by this holder example: 2.5 label_info: $ref: '#/components/schemas/AddressLabelInfo' description: >- Structured information about the address label including type and subtype example: accountAddress: TokenAccountAddress123 ownerAddress: ARD9GAKA6LAzufwqZ3BTKcnJmaeNyGHp3n7UU4eiJ3mS alias: Raydium AMM amount: 1000000 percentage: 12.34 label_info: label_type: dex label_name: Raydium AMM label_subtype: amm AddressLabelInfo: type: object properties: label_type: type: string description: Type of address (e.g., cex, dex, defi, nft) example: dex label_name: type: string description: The name/description of the entity example: Raydium AMM label_subtype: type: string description: More specific categorization example: amm responses: UnauthorizedError: description: Authorization information is missing or invalid content: application/json: example: message: Unauthorized securitySchemes: api_key: type: apiKey in: header name: x-api-key ````