Query Solana wallet PnL and token positions

Fetch a wallet summary for total returns, then query positions for the tokens behind those numbers. Use history for daily changes, charts for a time series, and risk data for current exposure.

Wallet summary

The wallet summary returns total PnL, win rate, token counts, and ROI distribution.

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}" \
  -H "x-api-key: YOUR_API_KEY"

const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";

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

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

import requests

wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"
res = requests.get(
    f"https://data.solanatracker.io/v2/pnl/wallets/{wallet}",
    headers={"x-api-key": "YOUR_API_KEY"}
)
data = res.json()

print(f"Total PnL: ${data['summary']['pnl']['total']:.2f}")
print(f"Win Rate: {data['analysis']['winRate']}%")

Currency denomination

Wallet summary, history, and performance support ?currency=usd|sol|eur (default usd). When you pass sol or eur, monetary values are converted at read time and the response includes a top-level "currency" field.

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}?currency=sol" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d&currency=eur" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/performance?period=30d&currency=sol" \
  -H "x-api-key: YOUR_API_KEY"

Historical SOL/EUR values are approximate — each day uses that day’s reference rate, so cumulative converted values won’t chain perfectly across days. Field names stay USD-oriented in some places (e.g. activity.volume.costUsd); use the top-level currency field to determine denomination.

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

Show only profitable positions

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

Show currently held tokens

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

Filter by minimum investment

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

Filter by specific market (e.g. pump.fun)

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

Single position

Use the wallet token position endpoint for one mint:

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.

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?start=2025-01-01&end=2025-01-31" \
  -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.

Choosing a time window

Time-range parameters vary by endpoint. Use the following options for history, performance, charts, and KOL period queries:

Parameter	Where it works	Notes
`period`	history, performance, KOL period	Shorthand enum: `1d`, `7d`, `14d`, `30d`, `90d`, `all`. Ignored when `start`/`end` are set.
`days`	performance	Integer number of days (default `30`, max `365`). Use this to ask for non-standard windows like `45` or `120`.
`start` / `end`	history, KOL period	Explicit `YYYY-MM-DD` calendar range. When either is set, `period` is ignored. Defaults: `start` = 30 days ago, `end` = today.
`time_from` / `time_to`	chart	Unix seconds. Pass `pagination.nextTimeTo` as `time_to` to load older points.

Use period or days only where the endpoint supports it. Pass start and end for an explicit date range on history and KOL period queries.

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 summarizes activity over the requested window:

Metric	Description
Total realized PnL	Sum of realized PnL in the window
Total trades	Sum of daily buy/sell activity within the window (`day_buys + day_sells`), not lifetime cumulative counts
Win/Loss streaks	Current and maximum consecutive winning/losing days
Maximum drawdown	Largest drop from the highest value to the lowest dip
Best/Worst days	The single best and worst trading days
Daily breakdown	Day-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:

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.

Token traders

See how a specific token was traded across wallets.

API Reference

Full schema details for the wallet summary response.

Start here

Token data

Wallets and PnL

Live data

Pump.fun

Prediction markets

Trading and RPC

Query Solana wallet PnL and token positions

Wallet summary

Currency denomination

Token positions

PnL mode

Common filters

Single position

PnL calendar

Choosing a time window

Chart data

Performance

Highlights

Biggest Winner

Biggest Loser

Fastest Flip

Longest Hold

Largest Bag

Most Traded

Risk

Live updates

Token traders

API Reference

​Wallet summary

​Currency denomination

​Token positions

​PnL mode

​Common filters

​Single position

​PnL calendar

​Choosing a time window

​Chart data

​Performance

​Highlights

Biggest Winner

Biggest Loser

Fastest Flip

Longest Hold

Largest Bag

Most Traded

​Risk

​Live updates

Token traders

API Reference

Wallet summary

Currency denomination

Token positions

PnL mode

Common filters

Single position

PnL calendar

Choosing a time window

Chart data

Performance

Highlights

Risk

Live updates