> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# August 6, 2026 - Cleaner Trader Rankings & Native Balances on Positions

> Trader positions no longer rank liquidity pools as traders, and both token positions endpoints can now return each wallet's native coin balance with the new includeNativeBalance flag.

**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
