Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt

Use this file to discover all available pages before exploring further.

KOLs (Key Opinion Leaders) are tracked Solana wallets with a public identity — usually a Twitter handle, name, and avatar. Use the KOL endpoints to rank them, compare performance over time, and feed their trades into alerts or dashboards. KOLScan leaderboard showing KOL wallet PnL, volume, and active days

​
List All KOLs

The KOL leaderboard returns all tracked KOL wallets ranked by performance. 
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols?sort=realized&direction=desc&limit=25" \
  -H "x-api-key: YOUR_API_KEY"

​
Sort Options

FieldDescription
totalTotal PnL (realized + unrealized)
realizedLocked-in profit
unrealizedPaper profit on open positions. Open positions are tokens still held.
investedTotal USD put in
roiReturn on investment
win_percentageWin rate
tradesNumber of trades
tokensNumber of tokens traded
last_tradeMost recent activity

​
Compare KOLs Over a Time Period

Use the period leaderboard to rank KOLs within a specific window. This is useful for finding who’s performing well recently, not just all-time. 
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/period?period=7d&sort=realized&direction=desc" \
  -H "x-api-key: YOUR_API_KEY"
Supported period shortcuts: 1d, 7d, 14d, 30d, 90d.

​
KOL Calendar (Monthly Heatmap)

The calendar endpoint returns aggregate KOL performance for each day in a month. Perfect for building heatmap UIs. 
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/calendar?year=2025&month=3" \
  -H "x-api-key: YOUR_API_KEY"
Each day includes total PnL, trade count, and active KOL count across the tracked set.
Color days by aggregate PnL to spot market-wide trends at a glance.

​
Single-Day KOL Breakdown

The daily breakdown shows every tracked KOL’s activity for one specific day. 
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/date?date=2025-03-15" \
  -H "x-api-key: YOUR_API_KEY"
Use this to answer questions like “what did KOLs trade on launch day?” or “who had the best day during the pump?”

​
Drill Into a KOL’s Wallet

Once you find a KOL worth investigating, pass their wallet address to the wallet analysis endpoints: 
// Get the KOL's full wallet summary
const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"; // from leaderboard

const summary = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());

console.log(`Total PnL: $${summary.summary.pnl.total.toFixed(2)}`);
console.log(`Win Rate: ${summary.analysis.winRate}%`);
console.log(`Tokens Traded: ${summary.summary.counts.tokensTraded}`);

// Then get their current positions
const positions = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}/positions?sort=value&direction=desc&limit=10`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());

positions.data.forEach(p => {
  console.log(`${p.meta.symbol}: $${p.pnl.total.toFixed(2)} PnL, holding $${p.position.valueUsd.toFixed(2)}`);
});

​
Build a Copy-Trading Feed

Combine KOL tracking with token trades to build a real-time feed of what KOLs are buying:
  1. Pull the KOL list from the leaderboard endpoint
  2. Check each wallet’s positions sorted by last_trade to see their latest moves
  3. Cross-reference tokens using the token info endpoint for metadata
  4. Set up alerts by polling positions periodically and diffing against previous state
// Get top 10 KOLs
const { traders: kols } = await fetch(
  "https://data.solanatracker.io/v2/pnl/leaderboard/kols?sort=realized&direction=desc&limit=10",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());

// Check each KOL's latest positions
for (const kol of kols) {
  const { data: positions } = await fetch(
    `https://data.solanatracker.io/v2/pnl/wallets/${kol.wallet}/positions?sort=last_trade&direction=desc&limit=5&filter=holding`,
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  ).then(r => r.json());

  console.log(`\n${kol.identity.name} (@${kol.identity.twitter}):`);
  positions.forEach(p => {
    console.log(`  ${p.meta.symbol}: $${p.position.valueUsd.toFixed(2)} held`);
  });
}

Wallet Analysis

Full guide for inspecting any wallet’s PnL, positions, and risk.

Leaderboards

KOL and top trader rankings with all sort and filter options.