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

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

}

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"
  }
}

Token

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. Early holder analysis is available for tokens launched within the last 12 months (data provider retention). Older tokens return data_availability: unsupported_token_age; previously analyzed tokens continue to return stored results.
EVM chains (eth, bsc, pol, arb, opt, base): Top holders and sniper detection. On BSC, early holder analysis is available for tokens deployed within the last 3 months (data provider retention). Older tokens return data_availability: unsupported_token_age; previously analyzed tokens continue to return stored results.
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>'

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

}

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.

Telling “no data” apart from “no answer”

A successful response with total_holders_count: 0 and empty analysis blocks means exactly that: we looked, and there was nothing to report. When we could not produce an answer, the response says so explicitly rather than looking like a zero. Always check data_availability before treating an empty result as a real finding:

`data_availability`	Meaning	What to do
(absent)	The analysis succeeded. An empty result is a genuine zero.	Use the result as-is.
`unsupported_token_age`	The token predates the data provider’s retention window (see above).	Don’t retry — the answer won’t change. Previously analyzed tokens keep returning their stored results.
`provider_unavailable`	An upstream data provider was unavailable for this request (rate limit, timeout, or an open circuit breaker), so no fresh analysis could be computed.	Retry. This is transient.

Both non-empty values are accompanied by data_availability_message, a human-readable explanation safe to surface to end users.

Provider unavailable

{
  "token_address": "0x15d4c048f83bd7e37d49ea4c83a07267ec4203da",
  "data_availability": "provider_unavailable",
  "data_availability_message": "Early holder analysis could not be computed because an upstream data provider was unavailable. This is a temporary condition — please retry.",
  "total_holders_count": 0
}

data_availability is returned alongside HTTP 200, not an error status, because a partial result may still be present — for example a cached analysis served with reduced token metadata. Treating any 200 as a complete answer without checking this field can silently turn a provider outage into a “this token has zero holders” conclusion.

The field is additive and may gain new values over time, so treat an unrecognized value as “analysis unavailable” rather than failing the parse.

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"

data_availability

enum<string>

Present when fresh early holder analysis cannot be computed. unsupported_token_age: the token launched before the data provider retention window (Solana: last 12 months, BSC: last 3 months). Tokens analyzed before the retention cutoff continue to return their stored results without this field.

Available options:

unsupported_token_age

Example:

"unsupported_token_age"

data_availability_message

string

Human-readable explanation of the data availability limitation. Only present alongside data_availability.

Example:

"Early holder analysis is only available for Solana tokens launched within the last 12 months due to data provider retention limits. Previously analyzed tokens continue to return stored results."

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

Stablecoins

RWA

Vault Risk V3

Vault Risk Rating (V2 — legacy)

Risk Intelligence

Migrations

Get detailed early holder analysis for a token

Telling “no data” apart from “no answer”

Authorizations

Path Parameters

Query Parameters

Response

​Telling “no data” apart from “no answer”

Authorizations

Path Parameters

Query Parameters

Response

Telling “no data” apart from “no answer”