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.

​
Wallet Summary

Start here. The wallet summary gives you the top-level view: total PnL, win rate, number of tokens traded, and ROI distribution. 
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}" \
  -H "x-api-key: YOUR_API_KEY"

​
Token Positions

The positions endpoint lists every token a wallet has traded. Sort by PnL, ROI, or value. Filter by holding state, market, minimum invested amount, and more.

​
PnL Mode

The wallet summary, positions, and single-position endpoints support ?pnlMode=strict|adjusted|raw. Default is strict, which filters out positions with sell amounts greater than buy amounts (usually invalid). Switch to adjusted for a cost-basis-corrected view, or raw to see everything unfiltered. See the Essentials for details. 
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions?pnlMode=adjusted" \
  -H "x-api-key: YOUR_API_KEY"

​
Common Filters

GET /v2/pnl/wallets/{wallet}/positions?filter=profit&sort=total&direction=desc

GET /v2/pnl/wallets/{wallet}/positions?filter=holding&sort=value&direction=desc

GET /v2/pnl/wallets/{wallet}/positions?minInvested=100&sort=roi&direction=desc

GET /v2/pnl/wallets/{wallet}/positions?market=pumpfun&sort=total&direction=desc

​
Single Position

To drill into one token, use the wallet token position endpoint: 
GET /v2/pnl/wallets/{wallet}/tokens/{token}
Returns the full position: realized/unrealized PnL, cost basis, current value, buy/sell counts, trade timing, and token metadata.

​
PnL Calendar

The PnL calendar endpoint shows how a wallet’s PnL changed day by day. PnL calendar showing daily green and red profit and loss cells 
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d" \
  -H "x-api-key: YOUR_API_KEY"
Each day includes:
  • Running totals — PnL, invested, and proceeds as of that day
  • Daily activity — that day’s realized PnL, volume, and trade counts
Use history when you need to explain what changed each day. Use chart when you need a visual equity curve.

​
Chart Data

The chart endpoint returns up to 180 daily data points for plotting equity, realized PnL, and activity. PnL chart showing realized profit over time, volume, win rate, and drawdown 
const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";

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

// points is an array of daily chart rows
// summary contains streaks, drawdown, and win-rate style aggregates
console.log(points.length, summary.winRate);
Use time_from and time_to (Unix seconds) to page through older data.

​
Performance

The performance endpoint gives you rolling stats: Wallet performance panel showing best day, worst day, streaks, and drawdown
MetricDescription
Total realized PnLSum of realized PnL in the window
Win/Loss streaksCurrent and maximum consecutive winning/losing days
Maximum drawdownLargest drop from the highest value to the lowest dip
Best/Worst daysThe single best and worst trading days
Daily breakdownDay-by-day PnL, volume, and trade counts
# Last 90 days performance
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/performance?days=90" \
  -H "x-api-key: YOUR_API_KEY"

​
Highlights

The highlights endpoint returns a wallet’s most notable positions: PnL highlights panel showing biggest winner, loser, bag, and fastest flip

Biggest Winner

The position with the highest realized PnL

Biggest Loser

The position with the worst realized loss

Fastest Flip

Shortest hold time with a profit

Longest Hold

The position held for the most time

Largest Bag

Current holding with the highest USD value

Most Traded

The token with the most buy/sell transactions
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/highlights" \
  -H "x-api-key: YOUR_API_KEY"

​
Risk

The risk endpoint evaluates current portfolio exposure: Wallet exposure panel showing open positions, cost basis, current value, and PnL mix
  • Portfolio concentration — how much is in the top 1 and top 5 positions
  • Realized vs unrealized split — is the wallet sitting on paper gains or locked-in profits?
  • Open position value — total USD value of current holdings
  • Risky holdings — list of tokens with low liquidity or high concentration risk
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/risk" \
  -H "x-api-key: YOUR_API_KEY"
Risk only covers current holdings. Sold positions aren’t included.

​
Live Updates

Keep a wallet in sync with the Datastream PnL V2 rooms instead of polling:
  • pnl:{wallet}:summary — total wallet PnL summary with realized/unrealized PnL, ROI, counts, averages, and open-position totals.
  • pnl:{wallet} — every token the wallet touches, tradeUpdate / balanceUpdate.
  • pnl:{wallet}:{token} — a single position.
Seed your UI with GET /v2/pnl/wallets/:wallet, then subscribe to the summary room. See the Datastream PnL guide for the full event payloads.

Next: Token Intelligence

See how a specific token was traded across wallets.

API Reference

Full schema details for the wallet summary response.