Skip to main content
GET
/
polymarket
/
trader
/
pnl
/
{address}
/
events
Get trader event PnL
curl --request GET \
  --url https://api.struct.to/v1/polymarket/trader/pnl/{address}/events
[
  {
    "event_slug": "<string>",
    "question": "<string>",
    "image_url": "<string>",
    "markets_traded": 123,
    "outcomes_traded": 123,
    "total_buys": 123,
    "total_sells": 123,
    "total_redemptions": 123,
    "total_merges": 123,
    "total_volume_usd": 123,
    "buy_usd": 123,
    "sell_usd": 123,
    "redemption_usd": 123,
    "merge_usd": 123,
    "realized_pnl_usd": 123,
    "winning_markets": 123,
    "losing_markets": 123,
    "total_fees": 123,
    "first_trade_at": 123,
    "last_trade_at": 123
  }
]

Path Parameters

address
string
required

Trader wallet address

Query Parameters

timeframe
enum<string>

Timeframe: 1d, 7d, 30d, lifetime (default: 7d)

Available options:
1d,
7d,
30d,
lifetime
sort_by
enum<string>

Sort: realized_pnl_usd, total_volume_usd, markets_traded, total_fees (default: realized_pnl_usd)

Available options:
realized_pnl_usd,
total_volume_usd,
markets_traded,
total_fees
sort_direction
enum<string>

Sort direction: asc, desc (default: desc)

Available options:
asc,
desc
limit
integer<int32>

Results limit (default: 10, max: 200)

pagination_key
string

Cursor-based pagination key

event_slug
string

Filter by event slug

Response

200 - application/json

Event-level PnL entries for this trader

event_slug
string | null
question
string | null
image_url
string | null
markets_traded
integer<int64> | null
outcomes_traded
integer<int64> | null
total_buys
integer<int64> | null
total_sells
integer<int64> | null
total_redemptions
integer<int64> | null
total_merges
integer<int64> | null
total_volume_usd
number<double> | null
buy_usd
number<double> | null
sell_usd
number<double> | null
redemption_usd
number<double> | null
merge_usd
number<double> | null
realized_pnl_usd
number<double> | null
winning_markets
integer<int64> | null
losing_markets
integer<int64> | null
total_fees
number<double> | null
first_trade_at
integer<int64> | null
last_trade_at
integer<int64> | null
Last modified on March 17, 2026