Skip to main content
GET
Wallet - PnL (Per Wallet)

Per-wallet PnL for one token.

  • Maximum number of wallets per request is 50.
  • pnl_method supports netcash and wac so per-wallet comparisons use the accounting method you expect.
  • token_metadata contains the token identity context for the request.
  • data[<wallet_address>] contains the PnL and trading metrics for each wallet.
  • Batch CU is calculated as ceil(10 * wallet_count^0.8).
  • Compare how multiple wallets performed on one token.
  • Rank a tracked wallet set by realized, unrealized, or total PnL for a single asset.
  • Build cohort studies across whales, smart money, or treasury wallets for one token.
  • Set the supported PnL chain in x-chain.
  • Pass one token_address.
  • Pass up to 50 wallet addresses in wallets.
  • Set pnl_method when this comparison must line up with summary, detail, or internal accounting outputs.
  • Use this endpoint when the token is fixed and the wallet cohort changes.
  • Deduplicate wallet addresses before sending the request.
  • Pair this endpoint with token-level trade or holder data when explaining why one cohort outperformed another.
  • Use the single-wallet endpoints when the wallet is fixed and the token set varies.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

The chain support PNL data.

Available options:
solana,
ethereum,
arbitrum,
avalanche,
bsc,
optimism,
polygon,
base,
zksync,
monad,
hyperevm,
mantle,
megaeth,
robinhood

Query Parameters

token_address
string
required

The address of the token contract.

wallets
string
required

List of wallet.

pnl_method
enum<string>
default:net_cash

PNL calculation method. wac (Weighted Average Cost): calculates PNL for each sell against the average cost of the position held at the time of the sell. Buys only re-average the cost of the remaining inventory, and previously realized sell PNL is not affected by later trades. netcash (Net Cash): calculates PNL across the full trade history using the spread between cumulative average sell price and cumulative average buy price. The buy average includes all buys and is not reduced by sells, so later buys can change the reported PNL.

Available options:
wac,
net_cash

Response

JSON object containing multiple wallet’s PnL per token

success
boolean
required

Whether the request succeeded.

data
object
required