Skip to main content
GET
/
holder-analysis
/
{address}
Get detailed early holder analysis for a token
curl --request GET \
  --url https://api.webacy.com/holder-analysis/{address} \
  --header 'x-api-key: <api-key>'
{
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "metadata": {
    "name": "USD Coin",
    "symbol": "USDC"
  }
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
address
string
required

Token contract address. For Solana: mint address. For EVM chains: ERC-20 token contract address. For Stellar 'CODE:ISSUER' format.

Query Parameters

​
chain
enum<string>
required

Blockchain network to analyze. Supported chains: sol (Solana), eth (Ethereum), bsc (BSC), pol (Polygon), arb (Arbitrum), opt (Optimism), base (Base), stellar (Stellar)

Available options:
sol,
eth,
bsc,
pol,
arb,
opt,
base,
stellar
​
useCache
boolean
default:true

Whether to use cached data if available (default: true)

​
refetchData
boolean
default:false

Whether to schedule a background refresh of analysis (default: false)

​
maxHolders
integer
default:10000

Maximum number of holders to analyze (default: 10000)

Required range: x <= 50000

Response

Successful operation

​
token_address
string

Address of the analyzed token

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
token_mint_tx
string

Transaction hash of token mint

Example:

"4JqaQUsu5mRADKcHYCL9X1VNDEfZfTmbsXCTSuSJpBXgxbZGQYTHBvzdrHj11NfcDDVEXbELpnEZYVWfpnJ1mgU7"

​
token_mint_time
string<date-time>

Timestamp when token was minted

Example:

"2023-03-21T13:00:22.000Z"

​
minter
string

Address of token minter

Example:

"FRgKuRNLRxTzChEKYgFZc5UiEBvZrBYNcRdmbEbXeS17"

​
first_buyers_analysis
object
​
top_10_holders_analysis
object
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"
      }
    }
  ]
}
​
dev_launched_tokens_in_24_hours
integer

Number of tokens launched by the same developer in 24 hours

Example:

3

​
sniper_analysis
object
​
metadata
object

Token metadata information including name, symbol, links, and other details