Query wallet and token PnL in batches

Batch known wallet addresses and token mints to reduce the number of requests. Position batches return token-level rows; wallet-summary batches return totals and identity labels.

When to use batch endpoints

Choose the request shape that matches your input list:

Portfolio Tracker

Fetch a wallet’s positions across 50+ tokens in one call

Token Dashboard

Get how 200 wallets performed on a specific token

Leaderboard Enrichment

Look up specific wallet+token pairs from leaderboard results

Batch endpoints return either positions or wallet summaries:

Position batches return token-level position rows and support pnlMode.
Wallet summary batch returns wallet-level summaries and wallet tags for up to 100 wallets. It does not accept pnlMode.

One wallet, many tokens

Use wallet batch positions for one wallet and a list of mints.

curl -X POST "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokens": [
      "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
      "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump",
      "CMx7yon2cLzHcXqgHsKJhuU3MmME6noWLQk2rAycBAGS"
    ]
  }'

const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";
const tokens = [
  "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
  "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
];

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}/positions/batch`,
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ tokens })
  }
);
const { positions, notFound } = await res.json();

positions.forEach(p => {
  console.log(`${p.meta.symbol}: $${p.pnl.total.toFixed(2)} PnL`);
});
if (notFound.length) {
  console.log(`Not traded: ${notFound.join(", ")}`);
}

import requests

wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"
tokens = [
    "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
    "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
]

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

for p in data["positions"]:
    print(f"{p['meta']['symbol']}: ${p['pnl']['total']:.2f}")

Limit: 100 tokens per request. Tokens the wallet never traded show up in the notFound array. Missing items are listed there; they are not request errors.

Many wallet summaries

Use POST /v2/pnl/wallets/batch when you only need wallet-level summaries and tags, not per-token positions. The request accepts up to 100 unique wallet addresses. Invalid addresses are returned in invalid, wallets without a PnL summary are returned in notFound, and requests with more than 100 unique valid wallets include a truncated object.

curl -X POST "https://data.solanatracker.io/v2/pnl/wallets/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
    ]
  }'

Each returned wallet mirrors the wallet-summary shape: wallet, identity, summary, tags, and updatedAt.

The batch response includes summary only. The analysis block from the single-wallet endpoint — including analysis.winRate, analysis.tokens.profitable, analysis.tokens.losing, analysis.maxSinglePnl, and the ending / pnlAdjustments fields — is not returned by POST /v2/pnl/wallets/batch. If you need winRate or any other analysis.* field for multiple wallets, call GET /v2/pnl/wallets/{wallet} once per wallet.

One token, many wallets

Use token batch positions to compare how multiple wallets performed on the same token.

curl -X POST "https://data.solanatracker.io/v2/pnl/tokens/{token}/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
    ]
  }'

const token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump";
const wallets = [
  "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
  "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
];

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/tokens/${token}/positions/batch`,
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ wallets })
  }
);
const { positions, notFound } = await res.json();

positions.forEach(p => {
  console.log(`${p.wallet}: $${p.pnl.token.total.toFixed(2)} on this token, ${p.counts.total} trades`);
});

Limit: 200 wallets per request.

Any wallet-token pairs

Use position batch lookup for a list of wallet-token pairs.

curl -X POST "https://data.solanatracker.io/v2/pnl/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pairs": [
      {
        "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
        "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
      },
      {
        "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
        "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
      }
    ]
  }'

const pairs = [
  { wallet: "CyaE1...", token: "38Pgz..." },
  { wallet: "CyaE1...", token: "84cAE..." },
  { wallet: "vines...", token: "38Pgz..." }
];

const res = await fetch("https://data.solanatracker.io/v2/pnl/positions/batch", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ pairs })
});
const { positions, notFound } = await res.json();

console.log(`Found ${positions.length} positions, ${notFound.length} not found`);

Limit: 200 pairs per request.

Which endpoint to use

You want…	Endpoint	Limit
One wallet’s PnL across 50 tokens	Wallet Batch	100 tokens
100 wallets’ PnL on one token	Token Batch	200 wallets
Specific wallet+token combos	Pair Batch	200 pairs
Wallet summaries and tags	`POST /v2/pnl/wallets/batch`	100 wallets

Unmatched inputs come back in a notFound array instead of causing errors. Always check it.

PnL mode

All three position batch endpoints accept ?pnlMode=strict|adjusted|raw as a query parameter. Default is strict. The wallet-summary batch endpoint does not accept pnlMode. See the Essentials for what each mode does.

curl -X POST "https://data.solanatracker.io/v2/pnl/positions/batch?pnlMode=adjusted" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pairs": [ ... ] }'

Trader rankings

Build a shortlist of wallets to batch-enrich.

Wallet PnL

Drill into a single wallet from your batch results.

Start here

Token data

Wallets and PnL

Live data

Pump.fun

Prediction markets

Trading and RPC

Query wallet and token PnL in batches

When to use batch endpoints

Portfolio Tracker

Token Dashboard

Leaderboard Enrichment

One wallet, many tokens

Many wallet summaries

One token, many wallets

Any wallet-token pairs

Which endpoint to use

PnL mode

Trader rankings

Wallet PnL

​When to use batch endpoints

Portfolio Tracker

Token Dashboard

Leaderboard Enrichment

​One wallet, many tokens

​Many wallet summaries

​One token, many wallets

​Any wallet-token pairs

​Which endpoint to use

​PnL mode

Trader rankings

Wallet PnL

When to use batch endpoints

One wallet, many tokens

Many wallet summaries

One token, many wallets

Any wallet-token pairs

Which endpoint to use

PnL mode