Build a Wallet Tracker

​

Find wallets worth tracking

• GET /v1/token/top-traders with timeframe=all is the lifetime leaderboard of a token: realized PnL, win rate over closed positions, current bag and its unrealized PnL, isDev / isSniper / isProTrader badges on every row.
• The same endpoint with timeframe=1h → 30d, or GET /v1/pool/top-traders for a single market, ranks by net flow over the window: who is printing right now.

const { data } = await sd<Trader[]>('/token/top-traders',
  { chain: 'solana', address: mint, timeframe: 'all', limit: 20 });

const candidates = data.filter((t) =>
  t.winRatePct !== null && t.winRatePct > 60 && t.realizedPnlUsd > 10_000 && !t.isSniper);

​

Who is behind the address

• GET /v1/wallet/profile resolves the identity: display name, ENS / Basename / .sol, avatar, bio, social accounts with follower counts, the pro-trader flag, and linkedWallets, other addresses of the same person from our identity graph of 7.6M+ labeled wallets. A KOL tracker is this one endpoint.
• GET /v1/wallet/funding answers where the wallet’s first funds came from: funder address, timestamp, amount, and funderTag when the funder is a known entity (exchange, bridge). A fresh wallet funded by another tracked wallet minutes before a launch is a signal; the insider and sybil heuristics start here.

const [{ data: p }, { data: f }] = await Promise.all([
  sd('/wallet/profile', { address: wallet }),
  sd('/wallet/funding', { chain, wallet }),
]);
// p.profile.displayName, p.profile.socials.twitter, p.profile.linkedWallets
// f.funder, f.fundedAt, f.funderTag ("Binance", a bridge such as "Relay.link", or null)

​

The dashboard

const panes = {
  positions: sd('/wallet/positions', { chain, wallet, includeNative: true, includeStables: true }),
  closed:    sd('/wallet/closed-positions', { chain, wallet, sort: 'pnl', limit: 20 }),
  pnl:       sd('/wallet/pnl', { chain: chain === 'solana' ? 'solana' : undefined, wallet, period: '30d' }),
  equity:    sd('/wallet/equity/history', { chain, wallet }),
};
for (const [pane, p] of Object.entries(panes))
  p.then((r) => render(pane, r), (e) => scheduleRetry(pane, e));

• Headline tiles: positions.meta.summary carries the wallet-level totals (totalValueUsd, realizedPnlUsd, unrealizedPnlUsd, totalPnlUsd, positions), computed over every position whatever the page. With includeNative and includeStables the total is the real account value, native coin and stablecoins read on-chain at request time.
• Win rate and cadence: pnl.data.summary has realizedPnlUsd, winRate, trades, wins, losses; pnl.data.history is the realized PnL series for the bar chart, daily buckets on 30d and all, hourly on 1d and 7d. Omit chain to combine every EVM chain in one figure.
• Equity curve: equity.data.points is the { at, valueUsd } series behind the portfolio chart, currentValueUsd the latest mark.
• Open positions: every row has the current bag (amount, amountUsd), entryPriceUsd vs currentPriceUsd, realized + unrealized PnL, and holdingSince, which resets when the wallet fully exits and re-enters: the honest “holding for 3d” display.
• Closed positions: the realized track record, sortable by PnL, with realizedPnlPercent (realized over total bought) per token. Across positions and closed-positions the realized PnL of a token is counted exactly once, so the two tables never double-count.

​

The activity feed

const seen = new Set<string>();

async function pollActivity(chain: string, wallet: string, onRow: (r: Swap) => void) {
  let cursor: string | undefined;
  while (true) {
    const { data, meta } = await sd<Swap[]>('/wallet/swaps', { chain, wallet, limit: 25, cursor });
    const fresh = data.filter((r) => !seen.has(r.id));
    fresh.forEach((r) => { seen.add(r.id); onRow(r); });
    if (fresh.length < data.length || !meta.hasMore) return;   // met a known row: caught up
    cursor = meta.nextCursor;                                  // burst bigger than a page: keep walking
  }
}
setInterval(() => pollActivity(chain, wallet, prependRow), 15_000);

​

Track a fleet

const items = fleet.map(({ chain, wallet }) => ({ chain, wallet }));
const [positions, pnl] = await Promise.all([
  sd2('/wallet/positions', { items, limit: 1 }),           // POST twin; summary covers ALL positions
  sd2('/wallet/pnl', { items, period: '7d' }),
]);
const rows = fleet.map((w, i) => ({
  ...w,
  valueUsd: positions.data[i].summary?.totalValueUsd ?? null,
  pnl7dUsd: pnl.data[i].data?.summary?.realizedPnlUsd ?? null,
}));

​

The copy-trade check

curl 'https://api.serialized.xyz/v1/wallet/positions?chain=solana&wallet=WALLET&tokens=MINT' \
  -H 'Authorization: YOUR_API_KEY'

​

What a tracker costs

​

Ship it