Wallet - PnL Details

post

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

Retrieve a wallet's overall PnL and trading statistics, along with aggregated PnL and trading details for each token.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Detailed wallet PnL breakdown.

Maximum number of tokens per request body is 100.
Body parameters include wallet, optional token_addresses, duration, position_scope, sort_by, sort_type, offset, and limit.
limit supports 1 to 100, and offset supports up to 10,000.
Use this endpoint when you need wallet-level summary plus token-level breakdown in one request.

Compute Unit ⚙️

This endpoint consumes 40 CU per request.

Use Cases 💡

Drill from wallet-level PnL into token-level contributors in one call.
Sort and page through the assets that drove gains or losses.
Support research views that need both summary and breakdown without multiple round trips.

How to Use 🛠️

Set the supported PnL chain in x-chain.
Send the wallet address in the POST body.
Optionally restrict the breakdown with token_addresses.
Use offset, limit, sort_by, and sort_type to control the returned token rows.

Best Practices ✅

Start with the summary endpoint when you need only headline metrics, then switch to details when the wallet warrants investigation.
Restrict token_addresses for focused investigations instead of always requesting a full breakdown.
Keep sort order stable across pagination so result slices are reproducible.

Body Params

wallet

string

required

token_addresses

array of strings

token_addresses

duration

string

enum

Defaults to all

Allowed:

position_scope

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:

sort_type

string

enum

Defaults to desc

Allowed:

sort_by

string

enum

Defaults to last_trade

Allowed:

limit

integer

1 to 100

Defaults to 10

offset

integer

0 to 10000

Defaults to 0

Headers

x-chain

string

enum

Defaults to solana

The chain support PNL data.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json