v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Wallet Pnl

Fetch realized profit and loss (PnL) for a specific wallet address.

Returns realized gains only - from confirmed sells or redeems.

When condition_id is provided, returns realized PnL for that specific market only. This handles split/merge operations correctly by aggregating both sides.

get/v2/polymarket/wallet/pnl/{wallet}

Path parameters

walletstring required

Wallet address to fetch PnL for

Wallet address to fetch PnL for

Query parameters

granularity'day' | 'week' | 'month' | 'year' | 'all' required

PnL granularity enum.

Time granularity for PnL data

start_timeinteger nullable

Unix timestamp (seconds) for start of range

Unix timestamp (seconds) for start of range

end_timeinteger nullable

Unix timestamp (seconds) for end of range

Unix timestamp (seconds) for end of range

condition_idstring nullable

Filter to a specific market by condition ID

Filter to a specific market by condition ID

Response

Successful Response

granularity'day' | 'week' | 'month' | 'year' | 'all' required

PnL granularity enum.

start_timeinteger required
end_timeinteger required
wallet_addressstring required
realized_pnlnumber nullable

Current total realized PnL (USD)

unrealized_pnlnumber nullable

Current unrealized PnL (USD), computed live from positions

fees_paidnumber nullable

Total taker fees paid (USD)

fees_refundednumber nullable

DEPRECATED: always 0. Refunds are already netted into fees_paid.

total_pnlnumber nullable

realized + unrealized - fees_paid (USD)