get
https://public-api.birdeye.so/wallet/v2/pnl/summary
Retrieve a wallet's overall PnL and trading statistics, including trade counts, win rate, cash flow, and realized and unrealized profit.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Wallet-level PnL summary.
- Notes on data: trade data per protocol are not fully backfilled and can affect calculated PnL.
durationacceptsall,90d,30d,7d, and24h.position_scopecontrols whether the summary uses duration-only or cumulative position interpretation.- Insights in the response:
counts:total_buy: Total number of buy trades.total_sell: Total number of sell trades.total_trade: Combined total of buys and sells.total_win: Total trades have profit. Only account for fully realized tokens.total_loss: Total trades in loss. Only account for fully realized tokens.win_rate: Winning rate. Only account for fully realized tokens.
cashflow_usd:total_invested: USD spent on all buys.total_sold: USD received from sales.current_value: Current position value in USD.
pnl:realized_profit_usd: Profit/loss from completed trades.realized_profit_percent: % gain/loss relative to sold cost basis.unrealized_usd: Profit/loss of current holdings (mark-to-market).total_usd: Sum of realized + unrealized profit in USD.avg_profit_per_trade_usd: Average profit/loss per trade.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
SVM ⛓️ ✨
EVM ⛓️ ✨
Compute Unit ⚙️
- This endpoint consumes
30 CUper request.
Use Cases 💡
- Get a fast wallet PnL summary without requesting token-by-token detail.
- Measure win rate, realized profit, unrealized exposure, and cash flow in one response.
- Power wallet overview cards, trader profile pages, and quick performance checks.
How to Use 🛠️
- Set the supported PnL chain in
x-chain. - Pass the wallet address in
wallet. - Choose
durationandposition_scopebased on whether you want recent or all-time context. - Use this summary endpoint before opening detailed breakdowns.
Best Practices ✅
- Compare realized and unrealized values together; a high total PnL can hide very different risk profiles.
- Keep the selected duration visible in product UI so users do not confuse recent and all-time performance.
- Use the detail endpoint when the summary reveals something worth investigating.