Skip to main content
GET
Wallet - PnL Chart

Realized PnL time series for one wallet.

  • position_scope supports duration_only and cumulative.
  • pnl_method supports netcash and wac so the chart can follow the same realized-PnL accounting method as your backend.
  • 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.
  • This endpoint consumes 30 CU per request.
  • 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.
  • 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.
  • Pass pnl_method explicitly when the chart must match summary and detail views exactly.
  • 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.
  • Maximum chart range is 100 days.

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

wallet
string
required

The wallet of the account.

position_scope
enum<string>
default: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.

Available options:
duration_only,
cumulative
time_from
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.

time_to
string

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

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 a wallet pnl chart

data
object[]
required

Time-series points for realized PnL and trading activity.

success
boolean

Whether the request succeeded.