Skip to main content
TL;DR: /2/token/trader-positions no longer returns liquidity pools as traders, and both token positions endpoints can now return each wallet’s native coin balance via the new opt-in includeNativeBalance parameter.

Cleaner Trader Rankings 🐛

GET /2/token/trader-positions ranks wallets by realized PnL — and liquidity pools, AMM/router contracts, and burn addresses could previously occupy ranks with zeroed metrics (buys=0, sells=0, pnl=0), displacing real traders.
  • Pools and AMM counterpart contracts are now excluded from the trader ranking entirely
  • GET /2/token/holder-positions is unchanged: pools legitimately appear there with the liquidityPool label
  • No latency impact (sub-2ms query plans preserved)

Native Balances on Token Positions ✨

New includeNativeBalance parameter (default false) on GET/POST /2/token/holder-positions and /2/token/trader-positions.
  • When set to true, nativeBalance and nativeBalanceRaw are populated for each returned wallet (SOL, ETH, BNB, …)
  • Balances are fetched over RPC at request time — live on-chain state, not indexed data
  • Off by default: responses are unchanged unless you opt in