v1

latestOpenAPI 3.1.02026-07-228799577.7 KB

Wallet

Get Wallet Token Position

Returns the full position for one wallet-token pair, wrapped with the wallet address, resolved identity, and the applied pnlMode.

get/v2/pnl/wallets/{wallet}/tokens/{token}

Path parameters

walletstring required

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

tokenstring required

Solana token mint 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.

Response

Successful response.

walletstring

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

tokenstring

Token mint address (base58).

investednumber nullable

Total cost basis (USD spent buying this token).

proceedsnumber nullable

Total USD received from sales of this token.

roinumber nullable

Return on investment percentage.

portfolioPercentnumber nullable

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