Skip to main content
GET
/
v1
/
polymarket
/
wallet
/
pnl
/
{wallet_address}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/wallet/pnl/0x1234...?granularity=day"

{
  "wallet_address": "0x1234567890abcdef...",
  "granularity": "week",
  "start_time": 1704067200,
  "end_time": 1735689600,
  "pnl_over_time": [
    {
      "timestamp": 1704067200,
      "pnl_to_date": 0.0
    },
    {
      "timestamp": 1704672000,
      "pnl_to_date": 250.50
    },
    {
      "timestamp": 1705276800,
      "pnl_to_date": 180.25
    },
    {
      "timestamp": 1705881600,
      "pnl_to_date": 425.75
    }
  ]
}

​
Overview

Fetch realized profit and loss over time for a wallet address. Returns cumulative P&L at each time period based on actual closed trades and redemptions.
This endpoint returns realized P&L only - from confirmed sells and redeems. For unrealized P&L, use the Positions endpoint.
​
wallet_address
string
required
Wallet address to fetch P&L for
​
granularity
string
required
Time granularity: day, week, month, year, or all
​
start_time
integer
Unix timestamp (seconds) for start of range
​
end_time
integer
Unix timestamp (seconds) for end of range
​
token_id
string
Optional token ID to filter P&L for a single position
​
wallet_address
string
The queried wallet address
​
granularity
string
The time granularity used
​
start_time
integer
Start of returned data range
​
end_time
integer
End of returned data range
​
pnl_over_time
array
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/wallet/pnl/0x1234...?granularity=day"

{
  "wallet_address": "0x1234567890abcdef...",
  "granularity": "week",
  "start_time": 1704067200,
  "end_time": 1735689600,
  "pnl_over_time": [
    {
      "timestamp": 1704067200,
      "pnl_to_date": 0.0
    },
    {
      "timestamp": 1704672000,
      "pnl_to_date": 250.50
    },
    {
      "timestamp": 1705276800,
      "pnl_to_date": 180.25
    },
    {
      "timestamp": 1705881600,
      "pnl_to_date": 425.75
    }
  ]
}

​
Granularity Options

GranularityData PointsBest For
dayOne per dayShort-term tracking
weekOne per weekMedium-term analysis
monthOne per monthQuarterly reviews
yearOne per yearMulti-year analysis
allSingle valueLifetime P&L

​
Understanding Realized P&L

Realized P&L is confirmed profit or loss from:
  1. Selling shares - Difference between sell price and average entry price
  2. Redeeming winners - $1.00 per share minus cost basis
  3. Losing positions - $0.00 per share (full loss of cost basis)
The P&L values are cumulative. Each data point shows total realized P&L up to that point in time.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Path Parameters

​
wallet_address
string
required

Wallet address to fetch PnL for

Query Parameters

​
granularity
enum<string>
required

Time granularity for PnL data

Available options:
day,
week,
month,
year,
all
​
start_time
integer | null

Unix timestamp (seconds) for start of range

​
end_time
integer | null

Unix timestamp (seconds) for end of range

​
token_id
string | null

Optional token ID to return PnL for a single token

Response

Successful Response

Wallet PnL endpoint response.

​
granularity
enum<string>
required

PnL granularity enum.

Available options:
day,
week,
month,
year,
all
​
start_time
integer
required
​
end_time
integer
required
​
wallet_address
string
required
​
pnl_over_time
PnLDataPoint · object[]
required