v1

latestOpenAPI 3.1.02026-07-228799577.7 KB

Token

Get Token Batch Positions

Returns positions for multiple wallets on one token mint in a single request. Wallets with no matching position are returned in notFound. Max 200 wallets.

post/v2/pnl/tokens/{token}/positions/batch

Path parameters

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.

Request body

walletsstring[] required

Wallet addresses to look up. Max 200.

Example request

{
  "wallets": [
    "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
    "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
  ]
}

Response

Positions found. Wallets that never traded this token appear in notFound.

tokenstring

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

countinteger

Number of positions returned

notFoundstring[]

Wallets that never traded this token

invalidstring[]

Addresses that failed Base58 validation. Omitted when empty.