API Endpoints

Wallet - PnL Chart

get
https://public-api.birdeye.so/wallet/v2/pnl/chart

Retrieve the realized PnL chart of a wallet.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Realized PnL time series for one wallet.

  • position_scope supports duration_only and cumulative.
  • time_from and time_to must use YYYY-MM-DD HH:mm:ss in UTC.
  • If omitted, the backend fills a default window bounded to at most 100 days.
  • The time range from time_from to time_to must not exceed 100 days.
Compute Unit ⚙️
  • This endpoint consumes 35 CU per request.
Use Cases 💡
  • Plot realized PnL over time for one wallet.
  • Compare cumulative versus duration-only profit behavior.
  • Support trader-performance charts and recent-versus-all-time performance analysis.
How to Use 🛠️
  • Set the supported PnL chain in x-chain.
  • Pass the wallet address in wallet.
  • Provide time_from and time_to in UTC when you need an explicit window.
  • Choose position_scope based on whether you want isolated interval behavior or cumulative progression.
Best Practices ✅
  • Use explicit windows for reporting jobs so charts are reproducible.
  • Keep chart labels clear about whether the series is cumulative or duration-only.
  • Pair the PnL chart with wallet summary metrics so users can reconcile line shape with total outcomes.
Limitations ⚠️
  • Maximum chart range is 100 days.

Query Params
string
required

The wallet of the account.

string
enum
Defaults to duration_only

Calculation mode for PnL. duration_only calculates PnL only for each selected time bucket. cumulative calculates realized_pnl cumulatively from the start time, while unrealized_pnl is based on the all-time open position. Defaults to duration_only.

Allowed:
string

Specify the start time in YYYY-MM-DD HH:mm:ss format. Defaults to 100 days before the current time. The time range between time_from and time_to must not exceed 100 days.

string

Specify the start time in YYYY-MM-DD HH:mm:ss format. Defaults to the current time.

string
enum
Defaults to 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.

Allowed:
Headers
string
enum
Defaults to solana

The chain support PNL data.

Responses

Updated about 1 month ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago

Did this page help you?