Market Top Traders

curl 'https://api.serialized.xyz/v1/pool/top-traders?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&timeframe=1d&limit=3' \
  -H 'Authorization: YOUR_API_KEY'

{
  "data": [
    {
      "rank": 1,
      "address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
      "buys": 11,
      "sells": 6,
      "boughtTokens": "48210339.5",
      "soldTokens": "40118207.1",
      "boughtNative": 1.740221,
      "soldNative": 2.994518,
      "boughtUsd": 3271.62,
      "soldUsd": 5629.69,
      "openTokens": "8092132.4",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 1.254297,
      "realizedPnlUsd": 2358.32,
      "avgBuyPriceNative": 0.0000000361,
      "winRatePct": null,
      "isDev": false,
      "isSniper": true,
      "isProTrader": true,
      "firstTradeAt": 1786820044000,
      "lastTradeAt": 1786901550000
    },
    {
      "rank": 2,
      "address": "0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c",
      "buys": 4,
      "sells": 4,
      "boughtTokens": "20110004.0",
      "soldTokens": "20110004.0",
      "boughtNative": 0.712004,
      "soldNative": 1.188771,
      "boughtUsd": 1338.57,
      "soldUsd": 2234.89,
      "openTokens": "0",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 0.476767,
      "realizedPnlUsd": 896.51,
      "avgBuyPriceNative": 0.0000000354,
      "winRatePct": null,
      "isDev": false,
      "isSniper": false,
      "isProTrader": null,
      "firstTradeAt": 1786841201000,
      "lastTradeAt": 1786899330000
    }
  ],
  "meta": {
    "asOf": 1786901933078,
    "usdBasis": "spot",
    "sortBy": "pnl",
    "order": "desc",
    "timeframe": "1d",
    "traderCount": 231
  }
}

GET

pool

top-traders

curl 'https://api.serialized.xyz/v1/pool/top-traders?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&timeframe=1d&limit=3' \
  -H 'Authorization: YOUR_API_KEY'

{
  "data": [
    {
      "rank": 1,
      "address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
      "buys": 11,
      "sells": 6,
      "boughtTokens": "48210339.5",
      "soldTokens": "40118207.1",
      "boughtNative": 1.740221,
      "soldNative": 2.994518,
      "boughtUsd": 3271.62,
      "soldUsd": 5629.69,
      "openTokens": "8092132.4",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 1.254297,
      "realizedPnlUsd": 2358.32,
      "avgBuyPriceNative": 0.0000000361,
      "winRatePct": null,
      "isDev": false,
      "isSniper": true,
      "isProTrader": true,
      "firstTradeAt": 1786820044000,
      "lastTradeAt": 1786901550000
    },
    {
      "rank": 2,
      "address": "0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c",
      "buys": 4,
      "sells": 4,
      "boughtTokens": "20110004.0",
      "soldTokens": "20110004.0",
      "boughtNative": 0.712004,
      "soldNative": 1.188771,
      "boughtUsd": 1338.57,
      "soldUsd": 2234.89,
      "openTokens": "0",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 0.476767,
      "realizedPnlUsd": 896.51,
      "avgBuyPriceNative": 0.0000000354,
      "winRatePct": null,
      "isDev": false,
      "isSniper": false,
      "isProTrader": null,
      "firstTradeAt": 1786841201000,
      "lastTradeAt": 1786899330000
    }
  ],
  "meta": {
    "asOf": 1786901933078,
    "usdBasis": "spot",
    "sortBy": "pnl",
    "order": "desc",
    "timeframe": "1d",
    "traderCount": 231
  }
}

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 dev/sniper/pro-trader badges. Same engine as Token Top Traders, scoped to one pool. EVM and Solana, one shape.

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. On Solana (usdBasis trade), boughtUsd, soldUsd and realizedPnlUsd 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 distinct wallets in the window.

curl 'https://api.serialized.xyz/v1/pool/top-traders?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&timeframe=1d&limit=3' \
  -H 'Authorization: YOUR_API_KEY'

{
  "data": [
    {
      "rank": 1,
      "address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
      "buys": 11,
      "sells": 6,
      "boughtTokens": "48210339.5",
      "soldTokens": "40118207.1",
      "boughtNative": 1.740221,
      "soldNative": 2.994518,
      "boughtUsd": 3271.62,
      "soldUsd": 5629.69,
      "openTokens": "8092132.4",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 1.254297,
      "realizedPnlUsd": 2358.32,
      "avgBuyPriceNative": 0.0000000361,
      "winRatePct": null,
      "isDev": false,
      "isSniper": true,
      "isProTrader": true,
      "firstTradeAt": 1786820044000,
      "lastTradeAt": 1786901550000
    },
    {
      "rank": 2,
      "address": "0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c",
      "buys": 4,
      "sells": 4,
      "boughtTokens": "20110004.0",
      "soldTokens": "20110004.0",
      "boughtNative": 0.712004,
      "soldNative": 1.188771,
      "boughtUsd": 1338.57,
      "soldUsd": 2234.89,
      "openTokens": "0",
      "positionValueNative": null,
      "positionValueUsd": null,
      "unrealizedPnlNative": null,
      "unrealizedPnlUsd": null,
      "totalPnlNative": null,
      "totalPnlUsd": null,
      "realizedPnlNative": 0.476767,
      "realizedPnlUsd": 896.51,
      "avgBuyPriceNative": 0.0000000354,
      "winRatePct": null,
      "isDev": false,
      "isSniper": false,
      "isProTrader": null,
      "firstTradeAt": 1786841201000,
      "lastTradeAt": 1786899330000
    }
  ],
  "meta": {
    "asOf": 1786901933078,
    "usdBasis": "spot",
    "sortBy": "pnl",
    "order": "desc",
    "timeframe": "1d",
    "traderCount": 231
  }
}

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

required

Pool / pair address (the stable market id on its chain - Uniswap V4 poolIds supported).

timeframe

default:1d

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

Available options:

1h

sortBy

pnl (default), 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

Response

200

Standard { data, meta } envelope.

Tokens

Wallets

Market & platform

Search & filters

Account usage

Authorizations

Query Parameters

Response