get
https://public-api.birdeye.so/wallet/v2/pnl/multiple
Retrieve all-time PnL and trading metrics for each specified wallet for a given token.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Per-wallet PnL for one token.
- Maximum number of wallets per request is
50. token_metadatacontains the token identity context for the request.data[<wallet_address>]contains the PnL and trading metrics for each wallet.
- Lite
- Starter
- Premium
- Business
- Enterprise
SVM ⛓️ ✨
EVM ⛓️ ✨
Compute Unit ⚙️
- Batch CU is calculated from a base of
10 CUand scales with wallet count.
Use Cases 💡
- 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.
How to Use 🛠️
- Set the supported PnL chain in
x-chain. - Pass one
token_address. - Pass up to
50wallet addresses inwallets. - Use this endpoint when the token is fixed and the wallet cohort changes.
Best Practices ✅
- 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.