Skip to main content
GET
/
v2
/
pnl
/
wallets
/
{wallet}
/
tokens
/
{token}
Get Wallet Token Position
curl --request GET \
  --url https://data.solanatracker.io/v2/pnl/wallets/{wallet}/tokens/{token} \
  --header 'x-api-key: <api-key>'
{
  "wallet": "<string>",
  "identity": {
    "name": "<string>",
    "twitter": "<string>",
    "avatar": "<string>",
    "type": "<string>",
    "tags": [
      "<string>"
    ],
    "platforms": [
      "<string>"
    ],
    "bot": {
      "name": "<string>",
      "avatar": "<string>"
    },
    "pool": {
      "program": "<string>",
      "poolAddress": "<string>"
    },
    "developer": {
      "token": "<string>",
      "via": [
        "<string>"
      ],
      "pools": [
        "<string>"
      ],
      "creationTx": "<string>",
      "createdAt": 123
    },
    "hacker": {
      "label": "<string>"
    },
    "spamDusting": {
      "label": "<string>"
    },
    "exchange": {
      "name": "<string>"
    }
  },
  "token": "<string>",
  "pnl": {
    "realized": 123,
    "realizedRaw": 123,
    "unrealized": 123,
    "total": 123
  },
  "invested": 123,
  "proceeds": 123,
  "roi": 123,
  "current": {
    "balance": 123,
    "costBasis": 123,
    "value": 123,
    "price": 123,
    "avgCost": 123
  },
  "volume": {
    "tokensBought": 123,
    "tokensSold": 123,
    "buyUsd": 123,
    "sellUsd": 123
  },
  "averages": {
    "buy": 123,
    "sell": 123
  },
  "counts": {
    "buys": 123,
    "sells": 123,
    "total": 123
  },
  "timing": {
    "firstBuy": 123,
    "lastBuy": 123,
    "firstSell": 123,
    "lastSell": 123,
    "firstTrade": 123,
    "lastTrade": 123,
    "holdTimeSecs": 123
  },
  "meta": {
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "price": 123,
    "liquidity": 123,
    "marketCap": 123,
    "primaryMarket": "<string>"
  },
  "portfolioPercent": 123
}

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

Path Parameters

wallet
string
required

Solana wallet address (base58, 32-44 characters).

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
token
string
required

Solana token mint address (base58, 32-44 characters).

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

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

Response

Successful response.

A single token position for a wallet.

wallet
string
identity
object

Unified wallet identity. Only fields with known values are returned; a wallet can carry multiple tags at once.

pnlMode
enum<string>
Available options:
strict,
adjusted,
raw
token
string

Token mint address (base58).

pnl
object

Realized, unrealized, and total profit/loss in USD.

invested
number | null

Total cost basis (USD spent buying this token).

proceeds
number | null

Total USD received from sales of this token.

roi
number | null

Return on investment percentage.

current
object
volume
object
averages
object
counts
object
timing
object
meta
object

Basic token metadata and current market data.

portfolioPercent
number | null

This position's value as a percentage of the wallet's total holdings value. Only present on the positions endpoint.