> ## Documentation Index > Fetch the complete documentation index at: https://docs.struct.to/llms.txt > Use this file to discover all available pages before exploring further. # Get top traders for a market > Top traders for a market, ranked by realized PnL desc. ## OpenAPI ````yaml https://api.struct.to/openapi.json get /polymarket/market/top-traders openapi: 3.1.0 info: title: Polymarket API description: >- RESTful API for querying Polymarket prediction markets data including events, markets, traders, holders, and real-time metrics license: name: '' version: 1.0.0 servers: - url: https://api.struct.to/v1 security: [] paths: /polymarket/market/top-traders: get: tags: - Market summary: Get top traders for a market description: Top traders for a market, ranked by realized PnL desc. operationId: get_market_top_traders parameters: - name: condition_id in: query description: Market condition ID required: false schema: type: string - name: market_slug in: query description: Market slug required: false schema: type: string - name: timeframe in: query description: 'Default: lifetime' required: false schema: $ref: '#/components/schemas/PnlTimeframe' - name: limit in: query description: Default 50, max 200 required: false schema: type: integer format: int32 - name: offset in: query description: >- Row skip; clamped to a max of 3500. Takes precedence over pagination_key. required: false schema: type: integer format: int32 - name: pagination_key in: query description: Cursor from a previous response required: false schema: type: string responses: '200': description: Top traders for the market content: application/json: schema: type: array items: $ref: '#/components/schemas/MarketEntry' '400': description: Invalid params components: schemas: PnlTimeframe: type: string enum: - 1d - 7d - 30d - lifetime MarketEntry: type: object required: - realized_pnl_usd - total_volume_usd - buy_volume_usd - sell_volume_usd - redemption_volume_usd - merge_volume_usd - total_fees - total_buys - total_sells - total_shares_bought - total_shares_sold - buy_count - sell_count - redeem_count - merge_count - split_count - converted_count - converted_shares_gained - converted_shares_lost - outcomes_traded - resolved - last_block properties: condition_id: type: - string - 'null' description: Condition ID. event_slug: type: - string - 'null' description: Event slug. market_slug: type: - string - 'null' description: Market slug. title: type: - string - 'null' description: Title. image_url: type: - string - 'null' description: Image URL. question: type: - string - 'null' description: Question. trader: oneOf: - type: 'null' - $ref: '#/components/schemas/TraderProfile' description: Trader wallet or profile. realized_pnl_usd: type: number format: double description: Realized PnL in USD. total_pnl_usd: type: number format: double description: Total PnL in USD. unrealized_pnl_usd: type: number format: double description: Unrealized PnL in USD. realized_pnl_pct: type: - number - 'null' format: double description: Realized PnL percent. total_pnl_pct: type: - number - 'null' format: double description: Total PnL percent. total_volume_usd: type: number format: double description: Total volume in USD. buy_volume_usd: type: number format: double description: Buy volume in USD. sell_volume_usd: type: number format: double description: Sell volume in USD. redemption_volume_usd: type: number format: double description: Redemption volume in USD. merge_volume_usd: type: number format: double description: Merge volume in USD. convert_collateral_usd: type: number format: double description: Convert collateral in USD. total_fees: type: number format: double description: Total fees. total_buys: type: integer format: int64 description: Total buys. minimum: 0 total_sells: type: integer format: int64 description: Total sells. minimum: 0 total_splits: type: integer format: int64 description: Number of split transactions in the selected timeframe. minimum: 0 total_shares_bought: type: number format: double description: Total shares bought. total_shares_sold: type: number format: double description: Total shares sold. buy_count: type: integer format: int64 description: Buy count. minimum: 0 sell_count: type: integer format: int64 description: Sell count. minimum: 0 redeem_count: type: integer format: int64 description: Redeem count. minimum: 0 merge_count: type: integer format: int64 description: Merge count. minimum: 0 split_count: type: integer format: int64 description: Split count. minimum: 0 split_volume_usd: type: number format: double description: USD collateral split into outcome tokens in the selected timeframe. converted_count: type: integer format: int64 description: Converted count. minimum: 0 converted_shares_gained: type: number format: double description: Converted shares gained. converted_shares_lost: type: number format: double description: Converted shares lost. outcomes_traded: type: integer format: int64 description: Outcomes traded. minimum: 0 resolved: type: boolean description: Resolved. won: type: - boolean - 'null' description: Won. first_trade_at: type: - integer - 'null' format: int64 description: First trade at timestamp. last_trade_at: type: - integer - 'null' format: int64 description: Last trade at timestamp. snapshot_ts: type: - integer - 'null' format: int64 description: Snapshot timestamp. last_block: type: integer format: int64 description: Last block. minimum: 0 TraderProfile: type: object required: - address - verified_badge properties: address: type: string description: Wallet address. name: type: - string - 'null' description: Name. pseudonym: type: - string - 'null' description: Pseudonym. profile_image: type: - string - 'null' description: Profile image. x_username: type: - string - 'null' description: X username. verified_badge: type: boolean description: Verified badge. ````