DEX Metrics API Overview

The DEX Metrics API provides quantitative analytics on token holder structures. It covers six areas: distribution metrics for concentration analysis, cluster detection to uncover related wallets, sniper tracking to identify early buyers, bundler detection to flag coordinated accumulation, insider tracking to monitor creator-linked wallets, and an overview endpoint that aggregates all metrics into a single call.

Base Path

/dex-metrics/v1

Backward compatibility: The same endpoints are still accessible at the legacy paths under /bubblemaps/v1/{network}/{token_address}/metrics/.... Those paths forward to the canonical /dex-metrics/v1 endpoints and will continue to work, but new integrations should use the paths below.

Endpoints

Endpoint	Description
`GET /{network}/{token_address}`	Aggregated overview of all holder metrics
`GET /{network}/{token_address}/distribution`	Holder distribution metrics (Gini, HHI, Nakamoto)
`GET /{network}/{token_address}/snipers`	Sniper detection and tracking
`GET /{network}/{token_address}/clusters`	Cluster analysis (related wallet groups)
`GET /{network}/{token_address}/bundlers`	Bundler detection (coordinated multi-wallet swaps)
`GET /{network}/{token_address}/insiders`	Insider tracking (creator-linked wallets)

Endpoint Details

Each endpoint has a dedicated page with full request/response examples, field reference, and interpretation guides:

Overview -- aggregated percentages for clusters and top-10 holder concentration in a single response. On Solana, also includes snipers, bundlers, dev holdings, and insiders. Available for sol, eth, base, bsc.
Distribution Metrics -- Gini coefficient, HHI, Nakamoto coefficient, and top-10 holder concentration. Measures how evenly spread a token's holders are.
Sniper Metrics -- identifies wallets that bought within the first few blocks of trading. Tracks whether they are still holding, sold, or accumulated more.
Cluster Metrics -- groups related wallets into clusters based on funding patterns, intermediary wallets, and transfer behaviour. Reveals true ownership behind multiple addresses.
Bundler Metrics -- identifies wallets that execute coordinated multi-wallet swaps within a single transaction or tight block window to accumulate tokens. Available for Solana.
Insider Metrics -- tracks wallets linked to the token creator or deployer. Available for Solana.