Get Wallet PnL
Polymarket
Wallet Profit-and-Loss
Realized profit and loss for a Polymarket wallet address over a specified time range and granularity.
GET
Get Wallet PnL
Fetches the realized PnL for a specific Polymarket wallet address over a specified time range and granularity. This tracks realized gains only — from either confirmed sells or redeems. A gain or loss is not realized until a finished market is redeemed.
Best for: Tracking wallet profitability, analyzing trading performance over time, building PnL dashboards, comparing realized returns across periods.
Endpoint:
GET /polymarket/wallet/pnl — wallet_address is a query parameter, not a path parameter.
Note: This returns realized PnL only, which differs from Polymarket’s dashboard that shows historical unrealized PnL.
Example
Response
The response returns thegranularity, start_time, end_time, and wallet_address fields, along with a pnl_over_time array. Each element in the array contains a timestamp and pnl_to_date value representing the cumulative realized profit and loss at that point in time.Authorizations
Your AIsa API key as a Bearer token.
Path Parameters
Pattern:
^0x[0-9a-fA-F]{40}$Example:
"0x1234567890abcdef1234567890abcdef12345678"
Query Parameters
Polymarket wallet address (0x-prefixed).
Available options:
day, week, month, year, all Example:
"day"
Defaults to first day of first trade if not provided.
Example:
1726857600
Defaults to the current date if not provided.
Example:
1758316829