Skip to main content
GET
Get top traders for a market

Query Parameters

condition_id
string

Market condition ID

market_slug
string

Market slug

timeframe
enum<string>

Default: lifetime

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

Default 50, max 200

offset
integer<int32>

Row skip; clamped to a max of 3500. Takes precedence over pagination_key.

pagination_key
string

Cursor from a previous response

Response

Top traders for the market

realized_pnl_usd
number<double>
required

Realized PnL in USD.

total_volume_usd
number<double>
required

Total volume in USD.

buy_volume_usd
number<double>
required

Buy volume in USD.

sell_volume_usd
number<double>
required

Sell volume in USD.

redemption_volume_usd
number<double>
required

Redemption volume in USD.

merge_volume_usd
number<double>
required

Merge volume in USD.

total_fees
number<double>
required

Total fees.

total_buys
integer<int64>
required

Total buys.

Required range: x >= 0
total_sells
integer<int64>
required

Total sells.

Required range: x >= 0
total_shares_bought
number<double>
required

Total shares bought.

total_shares_sold
number<double>
required

Total shares sold.

buy_count
integer<int64>
required

Buy count.

Required range: x >= 0
sell_count
integer<int64>
required

Sell count.

Required range: x >= 0
redeem_count
integer<int64>
required

Redeem count.

Required range: x >= 0
merge_count
integer<int64>
required

Merge count.

Required range: x >= 0
split_count
integer<int64>
required

Split count.

Required range: x >= 0
converted_count
integer<int64>
required

Converted count.

Required range: x >= 0
converted_shares_gained
number<double>
required

Converted shares gained.

converted_shares_lost
number<double>
required

Converted shares lost.

outcomes_traded
integer<int64>
required

Outcomes traded.

Required range: x >= 0
resolved
boolean
required

Resolved.

last_block
integer<int64>
required

Last block.

Required range: x >= 0
condition_id
string | null

Condition ID.

event_slug
string | null

Event slug.

market_slug
string | null

Market slug.

title
string | null

Title.

image_url
string | null

Image URL.

question
string | null

Question.

trader
null | object

Trader wallet or profile.

total_pnl_usd
number<double>

Total PnL in USD.

unrealized_pnl_usd
number<double>

Unrealized PnL in USD.

realized_pnl_pct
number<double> | null

Realized PnL percent.

total_pnl_pct
number<double> | null

Total PnL percent.

convert_collateral_usd
number<double>

Convert collateral in USD.

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

Won.

first_trade_at
integer<int64> | null

First trade at timestamp.

last_trade_at
integer<int64> | null

Last trade at timestamp.

snapshot_ts
integer<int64> | null

Snapshot timestamp.

Last modified on July 13, 2026