Wallet Analysis

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"

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

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.

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

The history, performance, and KOL period endpoints all accept rolling windows. They share the same three knobs:

Parameter	Where it works	Notes
`period`	history, KOL period	Shorthand enum: `1d`, `7d`, `14d`, `30d`, `90d`, `all`. Ignored when `start`/`end` are set.
`days`	performance, chart	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.

All three options produce rolling windows anchored to “now” unless you pin them with start/end. period=30d and days=30 return the same trailing-30-day window — pick whichever is more convenient. Send start/end only when you need an exact calendar range.

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:

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.

Next: Token Intelligence

See how a specific token was traded across wallets.

API Reference

Full schema details for the wallet summary response.

Overview

Token Data

Security & Analytics

Wallet & Portfolio

PnL V2

Live Streaming

Solana RPC

Trading

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

Next: Token Intelligence

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

Next: Token Intelligence

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