Skip to main content
GET
/
polymarket
/
market
/
top-traders
Get top traders for a market
curl --request GET \
  --url https://api.struct.to/v1/polymarket/market/top-traders
[
  {
    "trader": {
      "address": "<string>",
      "name": "<string>",
      "pseudonym": "<string>",
      "profile_image": "<string>",
      "x_username": "<string>",
      "verified_badge": true
    },
    "realized_pnl_usd": 123,
    "realized_pnl_pct": 123,
    "buy_usd": 123,
    "sell_usd": 123,
    "redemption_usd": 123,
    "merge_usd": 123,
    "total_fees": 123,
    "total_buys": 123,
    "total_sells": 123,
    "total_redemptions": 123,
    "total_merges": 123,
    "outcomes_traded": 123,
    "winning_outcomes": 123,
    "first_trade_at": 123,
    "last_trade_at": 123
  }
]

Query Parameters

condition_id
string

Market condition ID

market_slug
string

Market slug (alternative to condition_id)

timeframe
enum<string>

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

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

Results limit (default: 10, max: 200)

pagination_key
string

Pagination key from the previous response

Response

200 - application/json

Top traders sorted by realized PnL desc.

trader
object
required

Trader profile info - backwards compatibility

realized_pnl_usd
number<double> | null
realized_pnl_pct
number<double> | null
buy_usd
number<double> | null
sell_usd
number<double> | null
redemption_usd
number<double> | null
merge_usd
number<double> | null
total_fees
number<double> | null
total_buys
integer<int64> | null
total_sells
integer<int64> | null
total_redemptions
integer<int64> | null
total_merges
integer<int64> | null
outcomes_traded
integer<int64> | null
winning_outcomes
integer<int64> | null
first_trade_at
integer<int64> | null
last_trade_at
integer<int64> | null
Last modified on April 25, 2026