get https://public-api.birdeye.so/wallet/v2/pnl
Retrieve PnL of a wallet
- Maximum number of tokens per request: 50
meta
:address
: Wallet address.currency
: The currency in which PnL is calculated (e.g., usd).
tokens[<token_address>]
:symbol
: Token ticker (e.g., SOL, ...).decimals
: Number of decimal places the token uses.counts
:total_buy
: Total number of buy trades.total_sell
: Total number of sell trades.total_trade
: Combined total of buys and sells.
quantity
: Note: values are already normalized by10^-decimals
total_bought_amount
: Total token units purchased.total_sold_amount
: Total token units sold.holding
: Current balance (net holdings still in wallet).
cashflow_usd
:total_invested
: USD spent on all buys.cost_of_quantity_sold
: USD cost basis of the tokens already sold.total_sold
: USD received from sales.current_value
: Current USD value of remaining holdings.
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).unrealized_percent
: % unrealized gain/loss.total_usd
: Sum of realized + unrealized profit in USD.total_percent
: Overall ROI % including realized and unrealized.avg_profit_per_trade_usd
: Average profit/loss per trade.
pricing
:current_price
: Current market price per token in USD.avg_buy_cost
: Average buy price across trades (USD).avg_sell_cost
: Average sell price across trades (USD).