Aggregated token holder analysis in a single call.
GET /dex-metrics/v1/{network}/{token_address}Returns aggregated percentages across all DEX metric categories in a single call. This is the root path of the dex-metrics router.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
network | path | string | Yes | Network ID: sol, eth, base, bsc, sui |
token_address | path | string | Yes | Token contract address |
Example Request
curl -H "X-API-Key: YOUR_API_KEY" \
https://api.insightx.network/dex-metrics/v1/sol/pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9DfnResponse
{
"cluster_pct": 32.5,
"snipers_pct": 8.9,
"bundlers_pct": 4.2,
"dev_pct": 3.1,
"insiders_pct": 2.8,
"top10_pct": 45.3
}On EVM networks,
snipers_pct,bundlers_pct,dev_pct, andinsiders_pctwill be0.
Fields
| Field | Type | Description |
|---|---|---|
cluster_pct | number | Percentage of supply held by wallets belonging to detected clusters |
snipers_pct | number | Percentage of supply held by sniper wallets (0 on EVM) |
bundlers_pct | number | Percentage of supply held by bundler wallets (0 on EVM) |
dev_pct | number | Percentage of supply held by the token deployer/creator (0 on EVM) |
insiders_pct | number | Percentage of supply held by insider wallets, excluding dev (0 on EVM) |
top10_pct | number | Percentage of supply held by the top 10 holders (excluding known liquidity pools) |
Use Cases
- Dashboard summary widget -- display a compact overview of token holder distribution at a glance.
- Quick risk assessment -- evaluate concentration and known-entity exposure without multiple API calls.
- Comparing tokens side-by-side -- compare aggregated metrics across tokens for screening or ranking.
Network Support
| Network | Status |
|---|---|
Solana (sol) | Supported (all fields populated) |
Sui (sui) | Supported (all fields populated) |
Ethereum (eth) | Supported (snipers/bundlers/dev/insiders = 0) |
Base (base) | Supported (snipers/bundlers/dev/insiders = 0) |
BNB Smart Chain (bsc) | Supported (snipers/bundlers/dev/insiders = 0) |