v1

latestOpenAPI 3.1.02026-07-228799577.7 KB
Batch

Get Position Batch Lookup

Returns positions for arbitrary wallet and token pairs in a single request. Submit { wallet, token } objects; unmatched pairs come back in notFound. Max 200 pairs.

post/v2/pnl/positions/batch

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

Example request

{
  "pairs": [
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
    },
    {
      "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
    }
  ]
}

Response

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

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

Number of positions returned

invalidobject[]

Pairs that failed Base58 validation. Omitted when empty.