Skip to content

pnl

GEThttps://api.blink.trade/v1/pnl

Get account candles for a subaccount: per-bucket activity (realized P&L, fees, funding, flows, volume, closes) and the account state at each bucket close (equity, unrealized P&L, spot value). Buckets are aligned to the resolution, cover `[start_timestamp, end_timestamp)` up to the current bucket, and come oldest first; the newest `count_back` are returned and the last one may still be open. Buckets before the subaccount had any state are omitted. Equity marks positions at the bucket's closing mark price (or the fixed settlement price once a market is delisted), includes funding accrued since the position last settled, and values spot balances at the closing oracle price. Spot tokens without an oracle-priced market are excluded and listed in `unpriced_token_ids`. Flows of a non-quote token are valued at the bucket's closing price.

Query parameters

addressanyrequired

Base58 account address that decodes to 32 bytes.

subaccount_idint32required
min 0
resolutionstringrequired

`1h` buckets (kept for recent history) or `1d` buckets.

Show 2 enum values
1h1d
start_timestampint64required

Inclusive Unix timestamp in milliseconds.

min 0
end_timestampint64required

Exclusive Unix timestamp in milliseconds.

min 0
count_backint32required

Maximum rows returned.

min 1 max 500