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.

Use batch endpoints when you already know the wallets or tokens you want data for. They’re built for dashboards, scanners, data pipelines, and bulk historical loading.

​
When to Use Batch Endpoints

Batch endpoints are designed for scenarios where you need position data for multiple entities at once:

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
There are two kinds of batch endpoints:
  • 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 when you have one wallet and want to check multiple tokens at once. 
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"
    ]
  }'
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.

​
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"
    ]
  }'
Limit: 200 wallets per request.

​
Any Wallet-Token Pairs

Position batch lookup handles arbitrary combinations when every pair is different. 
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"
      }
    ]
  }'
Limit: 200 pairs per request.

​
Which Endpoint to Use

You want…EndpointLimit
One wallet’s PnL across 50 tokensWallet Batch100 tokens
100 wallets’ PnL on one tokenToken Batch200 wallets
Specific wallet+token combosPair Batch200 pairs
Wallet summaries and tagsPOST /v2/pnl/wallets/batch100 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": [ ... ] }'

Leaderboards

Build a shortlist of wallets to batch-enrich.

Wallet Analysis

Drill into a single wallet from your batch results.