curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&limit=900&offset=100' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&labels=kol,smartTrader&limit=50' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
"buys": 42,
"sells": 18,
"boughtTokens": "184320551.884",
"soldTokens": "151002317.9",
"boughtNative": 6.421889,
"soldNative": 11.038742,
"boughtUsd": 12073.15,
"soldUsd": 20752.83,
"openTokens": "33318233.984",
"positionValueNative": 1.532638,
"positionValueUsd": 2881.36,
"unrealizedPnlNative": 0.373139,
"unrealizedPnlUsd": 701.5,
"totalPnlNative": 4.989992,
"totalPnlUsd": 9380.81,
"realizedPnlNative": 4.616853,
"realizedPnlUsd": 8679.31,
"avgBuyPriceNative": 0.0000000348,
"avgSellPriceNative": 0.0000000731,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "33318233.984",
"amountRaw": "33318233984000000000000000",
"pctSupply": 0.0333,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"labels": ["sniper", "proTrader"],
"entityName": null,
"entityType": null,
"displayName": "@cryptotrader",
"avatarUrl": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar.jpg",
"twitter": "cryptotrader",
"platform": {
"id": "maestro",
"name": "Maestro",
"logo": "https://cdn.serialized.xyz/dex/platform-maestro.d4970d38.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1785801000000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "50000000000000000",
"fundingFromTag": "Coinbase",
"fundingFromLogo": null,
"firstTradeAt": 1785903211000,
"lastTradeAt": 1786901550000
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"buys": 9,
"sells": 7,
"boughtTokens": "52140339.11",
"soldTokens": "52140339.11",
"boughtNative": 1.884201,
"soldNative": 3.201778,
"boughtUsd": 3542.3,
"soldUsd": 6019.34,
"openTokens": "0",
"positionValueNative": 0,
"positionValueUsd": 0,
"unrealizedPnlNative": 0,
"unrealizedPnlUsd": 0,
"totalPnlNative": 1.317577,
"totalPnlUsd": 2477.02,
"realizedPnlNative": 1.317577,
"realizedPnlUsd": 2477.02,
"avgBuyPriceNative": 0.0000000361,
"avgSellPriceNative": 0.0000000614,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "0",
"amountRaw": "0",
"pctSupply": 0,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": null,
"fundingAt": null,
"fundingTxHash": null,
"fundingAmountNative": null,
"fundingFromTag": null,
"fundingFromLogo": null,
"firstTradeAt": 1786010044000,
"lastTradeAt": 1786877301000
}
],
"meta": {
"asOf": 1786901933078,
"usdBasis": "spot",
"sortBy": "pnl",
"order": "desc",
"timeframe": "all",
"traderCount": 18422
}
}
Token Top Traders
Ranked traders of a token from our own PnL fold: realized PnL in native and USD, tokens and native bought/sold, open position, average entry, win rate over closed positions, first/last trade, and the wallet labels of each trader (dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider). Lifetime by default, or any rolling window (1h → 30d).
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&limit=900&offset=100' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&labels=kol,smartTrader&limit=50' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
"buys": 42,
"sells": 18,
"boughtTokens": "184320551.884",
"soldTokens": "151002317.9",
"boughtNative": 6.421889,
"soldNative": 11.038742,
"boughtUsd": 12073.15,
"soldUsd": 20752.83,
"openTokens": "33318233.984",
"positionValueNative": 1.532638,
"positionValueUsd": 2881.36,
"unrealizedPnlNative": 0.373139,
"unrealizedPnlUsd": 701.5,
"totalPnlNative": 4.989992,
"totalPnlUsd": 9380.81,
"realizedPnlNative": 4.616853,
"realizedPnlUsd": 8679.31,
"avgBuyPriceNative": 0.0000000348,
"avgSellPriceNative": 0.0000000731,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "33318233.984",
"amountRaw": "33318233984000000000000000",
"pctSupply": 0.0333,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"labels": ["sniper", "proTrader"],
"entityName": null,
"entityType": null,
"displayName": "@cryptotrader",
"avatarUrl": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar.jpg",
"twitter": "cryptotrader",
"platform": {
"id": "maestro",
"name": "Maestro",
"logo": "https://cdn.serialized.xyz/dex/platform-maestro.d4970d38.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1785801000000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "50000000000000000",
"fundingFromTag": "Coinbase",
"fundingFromLogo": null,
"firstTradeAt": 1785903211000,
"lastTradeAt": 1786901550000
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"buys": 9,
"sells": 7,
"boughtTokens": "52140339.11",
"soldTokens": "52140339.11",
"boughtNative": 1.884201,
"soldNative": 3.201778,
"boughtUsd": 3542.3,
"soldUsd": 6019.34,
"openTokens": "0",
"positionValueNative": 0,
"positionValueUsd": 0,
"unrealizedPnlNative": 0,
"unrealizedPnlUsd": 0,
"totalPnlNative": 1.317577,
"totalPnlUsd": 2477.02,
"realizedPnlNative": 1.317577,
"realizedPnlUsd": 2477.02,
"avgBuyPriceNative": 0.0000000361,
"avgSellPriceNative": 0.0000000614,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "0",
"amountRaw": "0",
"pctSupply": 0,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": null,
"fundingAt": null,
"fundingTxHash": null,
"fundingAmountNative": null,
"fundingFromTag": null,
"fundingFromLogo": null,
"firstTradeAt": 1786010044000,
"lastTradeAt": 1786877301000
}
],
"meta": {
"asOf": 1786901933078,
"usdBasis": "spot",
"sortBy": "pnl",
"order": "desc",
"timeframe": "all",
"traderCount": 18422
}
}
GET /v1/token/top-traders · 2 credits
Ranked traders of a token from our own PnL fold: realized PnL in native and USD, tokens and native bought/sold, open position, average entry, win rate over closed positions, first/last trade, and the wallet labels of each trader (dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, insider). Lifetime by default, or any rolling window (1h → 30d). EVM and Solana, one shape.
limit (1 to 1000, default 20) is the page size and offset (default 0) the number of traders to skip: the ranking goes down to the 1 000th trader (offset + limit ≤ 1000, beyond 400 INVALID_PARAM). rank is absolute across pages and meta.traderCount gives the total. Same price whatever the page size.wallets (comma-separated or a list, at most 100 addresses) ranks only these wallets, without creating a watchlist: rank and meta.traderCount are then among them. Not with watchlist.labels (comma-separated or a list, any of them matches) keeps the traders carrying at least one of the requested wallet labels now: dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol, and insider on Solana. It searches the top 1 000 traders of the ranking you ask for (same timeframe, sortBy, order, pools, and among your wallets or watchlist when you pass one): a trader ranked below 1 000 is never returned. Each trader keeps its rank in that ranking; offset and limit page the filtered list, and meta.matched is how many of the top 1 000 carry a requested label. meta.traderCount stays the size of the whole ranking. 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 INVALID_PARAM (details.param: "labels"). Same price.amount (decimal string), amountRaw (raw units) and pctSupply are the wallet’s balance now and its share of the supply, as on /v1/token/holders: "0" once the wallet sold out, null when unknown (for instance on Solana for a trade a few seconds old). openTokens stays the position of the PnL: what the trades left, capped by the balance.avgBuyPriceNative and avgSellPriceNative are the average buy and sell prices in native. avgBuyPriceUsd and avgSellPriceUsd are served when the row’s USD is valued at each trade’s time (meta.usdBasis: trade, every Solana ranking and EVM rolling windows); on the EVM lifetime ranking (spot) they are null, never a past price at today’s rate.buyFeesUsd, sellFeesUsd and totalFeesUsd are the fees paid on the token’s swaps: network fees on EVM chains; network, priority tips and trading platform fees on Solana. On a rolling window, both chain families: the fees of the window’s transactions, counted once per transaction (a transaction that buys and sells the token counts on the buy side), valued like the row (meta.usdBasis); null when the network fee of one of the trader’s transactions in the window is not recorded: always on Arbitrum, Unichain, Monad and Plasma, often on BSC and X Layer, where some transactions carry no recorded fee. On the lifetime ranking: Solana, for positions opened since 2026-09-15; null on EVM chains and on older positions.pools= (a CSV of up to 200 pool addresses of the token) ranks the traders of those markets only; one pool gives the ranking of /v1/pool/top-traders. Without pools, every pool of the token. The lifetime ranking (timeframe=all, the default) covers the whole token: pools with it returns 400 INVALID_PARAM (details.param: "pools"), as does a pool of another token.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). On Solana, insider marks a wallet that received at least 0.01 % of the supply in one transfer without buying it, for tokens created since 2026-10-02, as on /v1/token/holders.entityName and entityType (cex, protocol, bridge…) name known entities; displayName, avatarUrl and twitter (the X handle, without @) are the wallet’s public profile, as /v1/wallet/profile serves it, for instance a KOL’s name and handle. Each is null when unknown.platform is the trading platform the wallet trades with (a terminal, bot, wallet app, aggregator, DEX router or launchpad app), on every timeframe, the same object as /v1/wallet/labels: id (a stable lowercase identifier such as axiom, gmgn, trojan, maestro), name and logo (an https URL, null when we host no logo for that platform). platform is null when not known.fundingFrom, fundingAt, fundingTxHash, fundingAmountNative (raw native units: wei, lamports), fundingFromTag and fundingFromLogo are the wallet’s first funding and its funder, with the same fields and rules as /v1/token/holders; null when unknown.meta echoes the resolved timeframe, sortBy and order, plus usdBasis - the basis of every USD figure in the response.0x0000…0000 on EVM, the SOL mint on Solana) is the quote of its chain’s markets and returns 400 INVALID_PARAM (its markets are listed by /v1/token/pools).realizedPnlNative is the wallet’s net native cashflow over the window (sold − bought) and winRatePct is null; win rate is measured over fully closed lifetime positions (timeframe=all).positionValue*, unrealizedPnl* and totalPnl* value the wallet’s current bag at the current price: served on the lifetime ranking (timeframe=all), null on a rolling window, and null while the token has no price yet. meta.usdBasis says how boughtUsd, soldUsd and the realized PnL were computed: trade = each trade valued at the native coin’s USD price at that trade’s minute, the basis of rolling windows on EVM and Solana and of the Solana lifetime ranking; spot = native amounts converted at the current native price, the basis of the EVM lifetime ranking. meta.traderCount is the number of wallets that ever traded the token (lifetime) or the number of distinct wallets in the window.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 (or in the window), and meta.watchlist gives the list’s id, the version applied and its wallets. A windowed ranking (timeframe other than all) over a list of more than 2,000 wallets on the chain needs at most 50,000 traders in the window: beyond, 400 INVALID_PARAM with details.param: "timeframe", use a smaller timeframe. An unknown or purged list returns 404. Same credits as without it.curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&limit=900&offset=100' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&labels=kol,smartTrader&limit=50' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"rank": 1,
"address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
"buys": 42,
"sells": 18,
"boughtTokens": "184320551.884",
"soldTokens": "151002317.9",
"boughtNative": 6.421889,
"soldNative": 11.038742,
"boughtUsd": 12073.15,
"soldUsd": 20752.83,
"openTokens": "33318233.984",
"positionValueNative": 1.532638,
"positionValueUsd": 2881.36,
"unrealizedPnlNative": 0.373139,
"unrealizedPnlUsd": 701.5,
"totalPnlNative": 4.989992,
"totalPnlUsd": 9380.81,
"realizedPnlNative": 4.616853,
"realizedPnlUsd": 8679.31,
"avgBuyPriceNative": 0.0000000348,
"avgSellPriceNative": 0.0000000731,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "33318233.984",
"amountRaw": "33318233984000000000000000",
"pctSupply": 0.0333,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"labels": ["sniper", "proTrader"],
"entityName": null,
"entityType": null,
"displayName": "@cryptotrader",
"avatarUrl": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar.jpg",
"twitter": "cryptotrader",
"platform": {
"id": "maestro",
"name": "Maestro",
"logo": "https://cdn.serialized.xyz/dex/platform-maestro.d4970d38.png"
},
"fundingFrom": "0x3c12b77ae8b7dd1feb63d1d6a2a819acda0a41d2",
"fundingAt": 1785801000000,
"fundingTxHash": "0x5f1c0a4f6b1e2d8c9a7b3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"fundingAmountNative": "50000000000000000",
"fundingFromTag": "Coinbase",
"fundingFromLogo": null,
"firstTradeAt": 1785903211000,
"lastTradeAt": 1786901550000
},
{
"rank": 2,
"address": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"buys": 9,
"sells": 7,
"boughtTokens": "52140339.11",
"soldTokens": "52140339.11",
"boughtNative": 1.884201,
"soldNative": 3.201778,
"boughtUsd": 3542.3,
"soldUsd": 6019.34,
"openTokens": "0",
"positionValueNative": 0,
"positionValueUsd": 0,
"unrealizedPnlNative": 0,
"unrealizedPnlUsd": 0,
"totalPnlNative": 1.317577,
"totalPnlUsd": 2477.02,
"realizedPnlNative": 1.317577,
"realizedPnlUsd": 2477.02,
"avgBuyPriceNative": 0.0000000361,
"avgSellPriceNative": 0.0000000614,
"avgBuyPriceUsd": null,
"avgSellPriceUsd": null,
"amount": "0",
"amountRaw": "0",
"pctSupply": 0,
"buyFeesUsd": null,
"sellFeesUsd": null,
"totalFeesUsd": null,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": null,
"labels": [],
"entityName": null,
"entityType": null,
"displayName": null,
"avatarUrl": null,
"twitter": null,
"platform": null,
"fundingFrom": null,
"fundingAt": null,
"fundingTxHash": null,
"fundingAmountNative": null,
"fundingFromTag": null,
"fundingFromLogo": null,
"firstTradeAt": 1786010044000,
"lastTradeAt": 1786877301000
}
],
"meta": {
"asOf": 1786901933078,
"usdBasis": "spot",
"sortBy": "pnl",
"order": "desc",
"timeframe": "all",
"traderCount": 18422
}
}
Query Parameters
all (default) ranks over the token's lifetime; 1h, 4h, 1d, 7d or 30d ranks over a rolling window. On a window, realizedPnlNative is the net native cashflow over the window and winRatePct is null.
all 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 (or in the window), meta.watchlist the list applied (wallets: its size at that version). Above 2,000 wallets on the chain, a windowed ranking needs at most 50,000 traders in the window (beyond: 400 on timeframe). The all-time ranking with watchlist counts 4 against the Traders group cap.
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 offset and limit page the filtered list (meta.matched counts the matching traders).
Response
Standard { data, meta } envelope.