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.

​
Token Traders

The token traders endpoint returns every wallet that traded a given token, with their current position and PnL. 
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/traders?sort=pnl&direction=desc&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Sorting Options

Sort FieldDescription
pnlTotal PnL
realizedRealized PnL only
unrealizedUnrealized PnL only
investedTotal USD invested
roiReturn on investment percentage
holdingCurrent token balance
valueCurrent USD value of the remaining position
first_tradeTime of first trade
last_tradeTime of most recent trade

​
Filtering Options

ParameterDescription
activeOnlyOnly show wallets currently holding the token
minTradesMinimum number of trades
excludeArbitrageExclude wallets flagged as arbitrage bots. Default: true — arbitrage PnL is noisy and the goal is tracking real traders. Pass false to include them.
excludeZeroBuysExclude wallets that received tokens without buying (airdrops, transfers). Default: true.
platformFilter by trading platform (axiom, bloom, photon). Comma-separated for multiple. axiom-flash is accepted as an axiom alias.
This endpoint does not accept pnlMode. The wallet-level PnL it returns (pnl.wallet) reflects the API’s wallet-summary view.

​
Response Shape: pnl.token vs pnl.wallet

Each trader carries two PnL objects:
  • pnl.token — realized / unrealized / total for this exact token only.
  • pnl.wallet — lifetime realized / unrealized / total across every token the wallet has traded.
This lets you spot, in one query, traders who are profitable on this token but underwater overall (and vice versa) without a second request.
QuestionField to use
Did this wallet profit on this token?pnl.token
Is this wallet profitable overall?pnl.wallet
Is the wallet still holding this token?position.balance
When did the wallet first buy?timing.firstTrade

​
Inline Identity

Each trader in the response includes a structured identity object. On token endpoints this is resolved against the token in the URL, so pool and developer tags automatically reflect the right token: 
"identity": {
  "tags": ["kol", "developer"],
  "kol": { "name": "Ansem", "twitter": "blknoiz06" },
  "developer": { "via": "creator", "creationTx": "5x7Y...", "createdAt": 1713600000000 }
}
Use this to filter snipers, spot the token dev buying their own launch, or surface KOL activity without a second request.

Filter for quality

Combine minTrades, activeOnly, and excludeArbitrage to remove bots and noise.

Cross-check wallets

Found an interesting trader? Run their wallet through the wallet analysis guide.

​
First Buyers

The first buyers endpoint returns the same data as token traders but is chronological only: earliest trade first, sort=first_trade, direction=asc. Use it for sniper detection and early-buyer analysis.
first-buyers rejects leaderboard-style sorting. For ROI, PnL, position size, latest trade, or descending order, use /v2/pnl/tokens/:token/traders.
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/first-buyers?limit=50" \
  -H "x-api-key: YOUR_API_KEY"
Cross-reference first buyers with the wallet summary to check if they’re real wallets, KOLs, or throwaway addresses.

​
Example: Snipers Who Already Sold

const token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump";

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/tokens/${token}/first-buyers?limit=50`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { traders } = await res.json();

// Early buyers who are fully out of the position
const snipersSold = traders.filter(t => 
  t.position.balance === 0 && t.pnl.token.realized > 0
);

console.log(`${snipersSold.length} early buyers already sold at a profit`);
snipersSold.forEach(t => {
  const holdMins = (t.timing.lastTrade - t.timing.firstTrade) / 60000;
  console.log(`  ${t.wallet}: +$${t.pnl.token.realized.toFixed(2)}, held ${holdMins.toFixed(0)} minutes`);
});
Typical workflow: token traders → shortlist interesting wallets → first buyers for launch behavior → wallet analysis for the full picture.

Wallet Analysis

Drill into a single wallet’s full PnL, positions, and risk profile.

Sniper Detection

More tools for finding early buyers, bundlers, and suspicious activity.