Skip to main content
POST
/
v2
/
pnl
/
positions
/
batch
Get Position Batch Lookup
curl --request POST \
  --url https://data.solanatracker.io/v2/pnl/positions/batch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "pairs": [
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
    },
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
    }
  ]
}
'
{
  "pnlMode": "strict",
  "count": 3,
  "positions": [
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "identity": {
        "name": "Cented",
        "twitter": "@Cented7",
        "avatar": "https://kol-avatar.solanatracker.io/CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
        "platforms": [
          "axiom",
          "bloom"
        ],
        "type": "kol",
        "tags": [
          "kol",
          "axiom",
          "bloom"
        ]
      },
      "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
      "pnl": {
        "realized": 88872.66,
        "unrealized": 0,
        "total": 88872.66
      },
      "invested": 3071.27,
      "proceeds": 91943.94,
      "roi": 2893.67,
      "current": {
        "balance": 0,
        "costBasis": 0,
        "value": 0,
        "price": 0.001572798005924808,
        "avgCost": 0
      },
      "volume": {
        "tokensBought": 46026806.173715,
        "tokensSold": 46026806.173715,
        "buyUsd": 3071.27,
        "sellUsd": 91943.94
      },
      "averages": {
        "buy": 341.25,
        "sell": 1242.49
      },
      "counts": {
        "buys": 9,
        "sells": 74,
        "total": 83
      },
      "timing": {
        "firstBuy": 1746044721229,
        "lastBuy": 1772031549416,
        "firstSell": 1746044751527,
        "lastSell": 1772032040873,
        "firstTrade": 1746044721229,
        "lastTrade": 1772032040873,
        "holdTimeSecs": 25987320
      },
      "meta": {
        "symbol": "gork",
        "name": "New XAI gork",
        "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs-forward.solanatracker.io%2Fipfs%2FQmXkHvTBRFMyY5ozYHXcF7JHqqLBTorca3dXAdF3ooD5e3",
        "decimals": 6,
        "price": 0.001572798005924808,
        "snapshotPrice": 0.001666646257827002,
        "marketCap": 1572419.01,
        "liquidity": 381495.96,
        "primaryMarket": "pumpfun-amm"
      }
    },
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump",
      "pnl": {
        "realized": 50791.19,
        "unrealized": 0,
        "total": 50791.19
      },
      "invested": 2621.72,
      "proceeds": 53412.92,
      "roi": 1937.32,
      "current": {
        "balance": 0,
        "costBasis": 0,
        "value": 0,
        "price": 0.000015786816405367,
        "avgCost": 0
      },
      "volume": {
        "tokensBought": 96296057.47450998,
        "tokensSold": 96296057.47451006,
        "buyUsd": 2621.72,
        "sellUsd": 53412.92
      },
      "averages": {
        "buy": 70.86,
        "sell": 346.84
      },
      "counts": {
        "buys": 37,
        "sells": 154,
        "total": 191
      },
      "timing": {
        "firstBuy": 1774277622281,
        "lastBuy": 1774294723039,
        "firstSell": 1774277870173,
        "lastSell": 1774296331666,
        "firstTrade": 1774277622281,
        "lastTrade": 1774296331666,
        "holdTimeSecs": 18709
      },
      "meta": {
        "symbol": "7",
        "name": "The 7 Wanderers",
        "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fedge.uxento.io%2Fimage%2FBxu1Dr8rLNBDyEutHRapKLdquDLeZkn8zkiUn9Avpump",
        "decimals": 6,
        "price": 0.000015786816405367,
        "snapshotPrice": 0.000022584238960459607,
        "marketCap": 15781.28,
        "liquidity": 13952.21,
        "primaryMarket": "pumpfun-amm"
      }
    }
  ],
  "notFound": []
}

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.

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Query Parameters

​
pnlMode
enum<string>
default:strict

How to treat positions flagged by the invalid PnL heuristic. strict zeros them out, adjusted caps them to a cost-basis-aware value, and raw leaves realized PnL untouched. Aliases pnl_mode and mode are also accepted by the API.

Available options:
strict,
adjusted,
raw

Body

application/json
​
pairs
object[]
required

Array of {wallet, token} objects. Max 200.

Maximum array length: 200
Example:
[
  {
    "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
    "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
  },
  {
    "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
    "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
  }
]

Response

Positions found. Pairs with no matching record appear in notFound.

​
pnlMode
enum<string>
Available options:
strict,
adjusted,
raw
​
count
integer

Number of positions returned

​
positions
object[]
​
notFound
object[]

Pairs with no matching position record

​
invalid
object[]

Pairs that failed Base58 validation. Omitted when empty.