curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-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,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"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,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": null,
"firstTradeAt": 1786010044000,
"lastTradeAt": 1786877301000
}
],
"meta": {
"asOf": 1786901933078,
"usdBasis": "spot",
"sortBy": "pnl",
"order": "desc",
"timeframe": "all",
"traderCount": 18422
}
}
Tokens
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 dev/sniper/pro-trader badges. Lifetime by default, or any rolling window (1h → 30d).
GET
/
v1
/
token
/
top-traders
curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-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,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"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,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": 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 dev/sniper/pro-trader badges. Lifetime by default, or any rolling window (1h → 30d). EVM and Solana, one shape.
meta echoes the resolved timeframe, sortBy and order, plus usdBasis - the basis of every USD figure in the response.Traders are ranked per token market: the EVM native coin (
0x0000…0000), which has no market of its own, returns 400 INVALID_PARAM (its markets are listed by /v1/token/pools).On a rolling window,
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. On Solana (usdBasis trade), boughtUsd, soldUsd and the realized PnL are valued at the SOL price at the time of each trade; on EVM chains (usdBasis spot), native amounts are converted at the current native price. meta.traderCount is the number of wallets that ever traded the token (lifetime) or the number of distinct wallets in the window.curl 'https://api.serialized.xyz/v1/token/top-traders?chain=evm:8453&address=0x3c5cd672b204ba0fc48e93b98c0922920a87912d&limit=3' \
-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,
"winRatePct": 71.42857142857143,
"isDev": false,
"isSniper": true,
"isProTrader": true,
"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,
"winRatePct": 85.71428571428571,
"isDev": false,
"isSniper": false,
"isProTrader": null,
"firstTradeAt": 1786010044000,
"lastTradeAt": 1786877301000
}
],
"meta": {
"asOf": 1786901933078,
"usdBasis": "spot",
"sortBy": "pnl",
"order": "desc",
"timeframe": "all",
"traderCount": 18422
}
}
Authorizations
Your raw API key (not needed on the demo server).
Query Parameters
Public chain id - evm:<id> or solana.
Token address.
timeframe
Option 1 · enum<string>Option 2 · enum<string>Option 3 · enum<string>Option 4 · enum<string>Option 5 · enum<string>Option 6 · enum<string>
default:all
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.
Available options:
all pnl (default), bought, sold or txns.
Available options:
pnl desc (default) or asc.
Available options:
asc 1-100. Default 20.
Required range:
1 <= x <= 100Response
200
Standard { data, meta } envelope.