v1

latestOpenAPI 3.1.02026-07-228799577.7 KB

Wallet

Get Wallet Batch Positions

Returns positions for one wallet across multiple token mints in a single request. Tokens with no matching position are returned in notFound. Max 100 tokens.

post/v2/pnl/wallets/{wallet}/positions/batch

Path parameters

walletstring required

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

Query parameters

pnlMode'strict' | 'adjusted' | 'raw'

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.

Request body

tokensstring[] required

Token mint addresses to look up. Max 100.

Example request

{
  "tokens": [
    "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
    "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump",
    "CMx7yon2cLzHcXqgHsKJhuU3MmME6noWLQk2rAycBAGS"
  ]
}

Response

Positions found. Tokens the wallet never traded appear in notFound.

walletstring

pnlMode'strict' | 'adjusted' | 'raw'

countinteger

Number of positions returned

notFoundstring[]

Token mints with no position for this wallet

invalidstring[]

Addresses that failed Base58 validation. Omitted when empty.