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>'

import requests

url = "https://api.webacy.com/holder-analysis/{address}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.webacy.com/holder-analysis/{address}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.webacy.com/holder-analysis/{address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.webacy.com/holder-analysis/{address}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.webacy.com/holder-analysis/{address}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.webacy.com/holder-analysis/{address}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "metadata": {
    "name": "USD Coin",
    "symbol": "USDC"
  }
}

Trading DD

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

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>'

import requests

url = "https://api.webacy.com/holder-analysis/{address}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.webacy.com/holder-analysis/{address}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.webacy.com/holder-analysis/{address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.webacy.com/holder-analysis/{address}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.webacy.com/holder-analysis/{address}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.webacy.com/holder-analysis/{address}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "metadata": {
    "name": "USD Coin",
    "symbol": "USDC"
  }
}

Data availability: early holder analysis is limited by data provider retention. Solana covers tokens launched within the last 12 months; BSC covers tokens deployed within the last 3 months. Requests for older tokens return HTTP 200 with data_availability: "unsupported_token_age" and a human-readable data_availability_message. Tokens analyzed before the retention cutoff continue to return their stored results.

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. For Hedera: HTS token ID in '0.0.X' native format (e.g., '0.0.8144307') or EVM address 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), sui (Sui), hedera (Hedera)

Available options:

sol,

eth,

bsc,

pol,

arb,

opt,

base,

stellar,

sui,

hedera

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

Show child attributes

top_10_holders_analysis

object

Show child attributes

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

Show child attributes

metadata

object

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

Show child attributes

⌘I

Overview

Stablecoin Risk

RWA Risk (v3)

Vault Risk V3

Vault Risk Rating (V2 — legacy)

Risk DD

Trading DD

Migrations

Get Detailed Early Holder Analysis for a Token

Authorizations

Path Parameters

Query Parameters

Response