Skip to main content
GET
/
polymarket
/
wallet
/
pnl
Get Wallet PnL
curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/wallet/pnl \
  --header 'Authorization: Bearer <token>'
{
  "granularity": "day",
  "start_time": 1726857600,
  "end_time": 1758316829,
  "wallet_address": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b",
  "pnl_over_time": [
    {
      "timestamp": 1726857600,
      "pnl_to_date": 2001
    }
  ]
}
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/pnlwallet_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

curl -X GET "https://api.aisa.one/apis/v1/polymarket/wallet/pnl?wallet_address=0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b&granularity=day&start_time=1726857600&end_time=1758316829" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

The response returns the granularity, 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

Authorization
string
header
required

Your AIsa API key as a Bearer token.

Path Parameters

wallet_address
string
required
Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x1234567890abcdef1234567890abcdef12345678"

Query Parameters

wallet_address
string
required

Polymarket wallet address (0x-prefixed).

granularity
enum<string>
required
Available options:
day,
week,
month,
year,
all
Example:

"day"

start_time
integer

Defaults to first day of first trade if not provided.

Example:

1726857600

end_time
integer

Defaults to the current date if not provided.

Example:

1758316829

Response

PnL response

granularity
string
Example:

"day"

start_time
integer
Example:

1726857600

end_time
integer
Example:

1758316829

wallet_address
string
Example:

"0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"

pnl_over_time
object[]