Wallets and PnL
Who a wallet is, what its figures cover, and how PnL, the current price and quote tokens are defined.
Any address's portfolio (liquidity positions included), who funded it and what it is known to be, its positions, value over time, every transaction and its PnL; several wallets at once, or the top wallets by label. Wallets and PnL defines every figure, Labels every label.
A wallet is the address that traded a swap, its trader. On BSC that is the transaction sender, or, inside an ERC-4337 bundle, the smart account whose operation made the swap. On Solana it is the fee payer, or the owner whose token accounts traded when someone else paid the fee. Swaps that a solver or filler makes to fill someone else's order belong to no wallet (trader: ""), and no wallet endpoint counts them.
Every wallet answer carries indexedSince, the unix ms of the chain's first indexed block, and the wallet's labels. Trades, positions and PnL cover only what happened after indexedSince: a token bought before then has no known cost. Balances are the exception: the portfolio reads them from the chain.
PnL
Per wallet and token, over its indexed swaps. B and S are the tokens bought and sold, Bp and Sp the same over priced swaps only, BU and SU the USD paid and received in those.
| Figure | Definition |
|---|---|
| Average buy, sell | BU / Bp and SU / Sp, null when the divisor is 0. A weighted average over the whole indexed history, not FIFO. |
| Realized | min(Sp, Bp) × (avg sell − avg buy): only the amount sold that priced buys cover has a known cost. 0 without sells; null with sells but no priced buy. |
| Open | max(0, B − S): what the trades leave held. Not the balance, which transfers change. |
| Unrealized | min(open, max(0, Bp − Sp)) × (price now − avg buy). Null without a price now or a priced buy, and null when no market could take open at that price: it is worth more than 10× the token's 24 h USD volume, or the price values the token over $100M while the pool it comes from holds under $1k (the rule that leaves such a token without a market cap). |
| Total | Realized plus unrealized; null only when both are. |
| In a window | Realized counts the window's sells against the all-time average buy, over min(Sp in the window, Bp). Unrealized is always as of now. |
Price now
A token's price now is its price in its chart pool: the pool where it was the base with the most USD volume over its last 24 hourly buckets (for a token that is never the base, the busiest pool that prices it), from that pool's latest priced swap worth at least $0.01. BNB and SOL are priced as WBNB and WSOL. Prices are recomputed every 30 s.
Quote tokens
Stablecoins, and the native and wrapped native token, are listed as positions with quote: true but left out of every wallet total, win rate and distribution: their PnL is the price move of the currency a trader pays with, and each of their trades already counts on the other side.