Skip to main content
GET
/
polymarket
/
trader
/
top_trades_markets
Get top markets across all traders
curl --request GET \
  --url https://api.struct.to/v1/polymarket/trader/top_trades_markets
[
  {
    "realized_pnl_usd": 123,
    "total_volume_usd": 123,
    "buy_volume_usd": 123,
    "sell_volume_usd": 123,
    "redemption_volume_usd": 123,
    "merge_volume_usd": 123,
    "total_fees": 123,
    "total_buys": 1,
    "total_sells": 1,
    "total_shares_bought": 123,
    "total_shares_sold": 123,
    "buy_count": 1,
    "sell_count": 1,
    "redeem_count": 1,
    "merge_count": 1,
    "split_count": 1,
    "converted_count": 1,
    "converted_shares_gained": 123,
    "converted_shares_lost": 123,
    "outcomes_traded": 1,
    "resolved": true,
    "last_block": 1,
    "condition_id": "<string>",
    "event_slug": "<string>",
    "market_slug": "<string>",
    "title": "<string>",
    "image_url": "<string>",
    "question": "<string>",
    "trader": {
      "address": "<string>",
      "verified_badge": true,
      "name": "<string>",
      "pseudonym": "<string>",
      "profile_image": "<string>",
      "x_username": "<string>"
    },
    "total_pnl_usd": 123,
    "unrealized_pnl_usd": 123,
    "realized_pnl_pct": 123,
    "total_pnl_pct": 123,
    "convert_collateral_usd": 123,
    "total_splits": 1,
    "split_volume_usd": 123,
    "won": true,
    "first_trade_at": 123,
    "last_trade_at": 123,
    "snapshot_ts": 123
  }
]

Query Parameters

timeframe
enum<string>

Default: lifetime

Available options:
1d,
7d,
30d,
lifetime
limit
integer<int32>

Default 50, max 200

offset
integer<int32>

Max 2500. Takes precedence over pagination_key.

pagination_key
string

Cursor from a previous response

Response

Top markets page

realized_pnl_usd
number<double>
required
total_volume_usd
number<double>
required
buy_volume_usd
number<double>
required
sell_volume_usd
number<double>
required
redemption_volume_usd
number<double>
required
merge_volume_usd
number<double>
required
total_fees
number<double>
required
total_buys
integer<int64>
required
Required range: x >= 0
total_sells
integer<int64>
required
Required range: x >= 0
total_shares_bought
number<double>
required
total_shares_sold
number<double>
required
buy_count
integer<int64>
required
Required range: x >= 0
sell_count
integer<int64>
required
Required range: x >= 0
redeem_count
integer<int64>
required
Required range: x >= 0
merge_count
integer<int64>
required
Required range: x >= 0
split_count
integer<int64>
required
Required range: x >= 0
converted_count
integer<int64>
required
Required range: x >= 0
converted_shares_gained
number<double>
required
converted_shares_lost
number<double>
required
outcomes_traded
integer<int64>
required
Required range: x >= 0
resolved
boolean
required
last_block
integer<int64>
required
Required range: x >= 0
condition_id
string | null
event_slug
string | null
market_slug
string | null
title
string | null
image_url
string | null
question
string | null
trader
object
total_pnl_usd
number<double>
unrealized_pnl_usd
number<double>
realized_pnl_pct
number<double> | null
total_pnl_pct
number<double> | null
convert_collateral_usd
number<double>
total_splits
integer<int64>

Number of split transactions in the selected timeframe.

Required range: x >= 0
split_volume_usd
number<double>

USD collateral split into outcome tokens in the selected timeframe.

won
boolean | null
first_trade_at
integer<int64> | null
last_trade_at
integer<int64> | null
snapshot_ts
integer<int64> | null
Last modified on June 13, 2026