DEX Metrics Stream

Stream name: dex_metrics

The DEX Metrics stream is a unified real-time feed that delivers comprehensive token holder analysis as a single stream. Instead of subscribing to individual metric streams separately, subscribe once to dex_metrics and receive all holder analysis events for the tokens you're watching.

What's Included

Each dex_metrics event contains the following holder analysis data. All fields are always present.

Metric	Description
Top-10 Distribution	Percentage of supply held by the top 10 holders (excluding known liquidity pools)
Clusters	Groups of related wallets identified through on-chain funding patterns, intermediary wallets, and transfer behaviour
Snipers	Wallets that bought within the first few blocks of trading -- their count, behaviour, and current holdings
Bundlers	Wallets that executed coordinated multi-wallet swaps to accumulate tokens while appearing as separate buyers
Insiders	Wallets linked to the token creator or deployer
Dev Holdings	Current balance and supply percentage held by the token deployer

Clusters are one of InsightX's key differentiators -- the ability to uncover hidden relationships between wallets that appear independent but are controlled by the same entity.

Subscribing

Single Token

{
  "op": "subscribe",
  "network": "sol",
  "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "stream": "dex_metrics"
}

Multiple Tokens

{
  "op": "subscribe",
  "subs": [
    { "network": "sol", "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", "stream": "dex_metrics" },
    { "network": "sol", "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "stream": "dex_metrics" }
  ]
}

Event Format

{
  "op": "event",
  "network": "sol",
  "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "stream": "dex_metrics",
  "timestamp": "2026-03-01T12:00:00.000Z",
  "data": {
    "top10_pct": 45.3,
    "snipers_pct": 8.9,
    "bundlers_pct": 4.2,
    "insiders_pct": 2.8,
    "dev_pct": 3.1,
    "cluster_pct": 32.5
  }
}

Data Reference

Top-Level `data` Fields

Field	Type	Description
`top10_pct`	number	Percentage of supply held by the top 10 holders (excluding known liquidity pools)
`cluster_pct`	number	Total percentage of supply held by wallets belonging to detected clusters
`snipers_pct`	number	Total percentage of supply held by all identified snipers (0 on EVM)
`bundlers_pct`	number	Total percentage of supply held by all detected bundlers (0 on EVM)
`insiders_pct`	number	Total percentage of supply held by insider wallets, excluding dev (0 on EVM)
`dev_pct`	number	Percentage of supply held by the token deployer/creator (0 on EVM)

Why Use the Unified Stream

The dex_metrics stream is the most efficient way to get real-time holder analysis:

Single subscription -- one stream covers all metric types instead of managing multiple subscriptions.
Complete picture -- every event contains all holder categories, making it easy to build comprehensive dashboards.
Consistent timing -- all metrics in a single event are computed at the same point in time, avoiding synchronisation issues.

Network Support

Network	Status
Solana (`sol`)	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)

For cluster-only streaming on all networks (including monad, xlayer, abs), use the dedicated Clusters Stream.