Skip to main content
GET
GET /v1/pool/top-traders · 2 credits Ranked traders of a single market (pool) over a rolling window: net native PnL, tokens and native bought/sold, open position, average entry, first/last trade, and the wallet labels of each trader (dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider). Same engine as Token Top Traders, scoped to one pool. EVM and Solana, one shape.
labels lists the trader’s wallet labels as they stand now, in a fixed order; isDev, isSniper and isProTrader agree with it (null when unknown). Each row also carries the wallet’s identity (entityName, entityType, displayName, avatarUrl, twitter), its trading platform (platform), first funding (fundingFrom, fundingAt, fundingTxHash, fundingAmountNative, fundingFromTag, fundingFromLogo) and the fees of the window (buyFeesUsd, sellFeesUsd, totalFeesUsd), as on Token Top Traders.
meta echoes the resolved timeframe, sortBy and order, plus usdBasis - the basis of every USD figure in the response.
realizedPnlNative is each trader’s net native cashflow over the window (sold − bought); winRatePct, positionValue*, unrealizedPnl* and totalPnl* are null on windowed rankings. For lifetime PnL, win rate and the current bag’s value, use Token Top Traders with timeframe=all. boughtUsd, soldUsd and realizedPnlUsd are valued at the native coin’s USD price at the time of each trade, on EVM and Solana alike (usdBasis trade = each trade valued at the native coin’s USD price at that trade’s minute); meta.traderCount is the number of distinct wallets in the window.
Labels filter. labels (comma-separated or a list, any of them matches) keeps the traders carrying at least one of the requested wallet labels now (insider on Solana only), searched among the top 1 000 traders of the pool’s ranking, as on Token Top Traders: each trader keeps its rank, limit returns the first of the matching traders, and meta.matched is how many of the top 1 000 carry a requested label. The response carries meta.labelBasis (current) and meta.labelCoverage, as on /v1/token/holders. An unknown label, liquidityPool, or insider on EVM chains returns 400. Same price.
Watchlist. watchlist=<id> ranks only the wallets of one of your watchlists, with the same timeframe, sortBy, order and limit: its wallets on the requested chain (on an EVM chain, those added with chains: "evm" too), whatever the size of the list. rank is then the position among them, meta.traderCount the number of them that traded the token in the window, and meta.watchlist gives the list’s id, the version applied and its wallets. With more than 2,000 wallets on the chain, the window needs at most 50,000 traders: beyond, 400 INVALID_PARAM with details.param: "timeframe", use a smaller timeframe. An unknown or purged list returns 404. Same credits as without it.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana.

address
string

Pool / pair address (the stable market id on its chain - Uniswap V4 poolIds supported). Or send it as poolAddress.

poolAddress
string

The explicit name of address (the pool): send one of the two.

timeframe
default:1d

Rolling window: 1h, 4h, 1d (default), 7d or 30d.

Available options:
1h
sortBy

pnl (default, realized PnL in native), pnlUsd (realized PnL in USD, realizedPnlUsd), bought, sold or txns.

Available options:
pnl
order

desc (default) or asc.

Available options:
asc
limit
integer
default:20

1-100. Default 20.

Required range: 1 <= x <= 100
watchlist
string

Id of one of your watchlists: the same ranking among its wallets on the chain (on an EVM chain, those added with chains: "evm" too), any list size. rank is the position among them, meta.traderCount the number of them that traded the token in the window, meta.watchlist the list applied. Above 2,000 wallets on the chain, the window needs at most 50,000 traders (beyond: 400 on timeframe).

labels

Keep only the traders carrying at least one of these labels now, comma-separated or as a list: dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider (Solana only). Searched among the top 1000 traders of the requested ranking; each trader keeps its rank, and limit returns the first of the filtered list (meta.matched counts the matching traders).

Response

200

Standard { data, meta } envelope.