> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Leaderboard

> Leaderboard for a specific market

Wallet rankings for trading performance within a single market. Filter by entry/sell prices, edge, and volume to find the best-performing traders on any market.

<Note>**Requires Dev or Pro tier.** This endpoint is not available on the Free tier.</Note>

<Warning>
  **Rolling total PnL accuracy timeline** - Total PnL (realized + unrealized - net fees) uses rolling windows that need time to accumulate full data:

  * **All-time total PnL**: accurate immediately (February 10, 2026)
  * **1-day rolling total PnL**: fully accurate starting February 11, 2026
  * **7-day rolling total PnL**: fully accurate starting February 17, 2026
  * **30-day rolling total PnL**: fully accurate starting March 12, 2026
</Warning>

| Constraint | Value               |
| ---------- | ------------------- |
| `limit`    | 1–100 (default 100) |


## OpenAPI

````yaml GET /v2/polymarket/leaderboard/market/{condition_id}
openapi: 3.1.0
info:
  title: Predexon API
  description: Prediction market data aggregation and matching API
  version: 2.0.0
servers:
  - url: https://api.predexon.com
security:
  - apiKey: []
paths:
  /v2/polymarket/leaderboard/market/{condition_id}:
    get:
      tags:
        - polymarket
        - smart-wallet
      summary: Get Market Leaderboard
      description: |-
        Get leaderboard for a specific market.

        Shows wallet rankings for trading performance within a single market.
      operationId: >-
        get_market_leaderboard_v2_polymarket_leaderboard_market__condition_id__get
      parameters:
        - name: condition_id
          in: path
          required: true
          schema:
            type: string
            title: Condition Id
            description: Market condition ID
          description: Market condition ID
        - name: window
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/TimeWindow'
            description: Time window
            default: all_time
          description: Time window
        - name: sort_by
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/LeaderboardSortBy'
            description: Sort field
            default: total_pnl
          description: Sort field
        - name: order
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/OrderDirection'
            description: Sort order
            default: desc
          description: Sort order
        - name: min_total_pnl
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Minimum total PnL in this market (USD, net of fees)
            title: Min Total Pnl
          description: Minimum total PnL in this market (USD, net of fees)
        - name: max_total_pnl
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Maximum total PnL in this market (USD, net of fees)
            title: Max Total Pnl
          description: Maximum total PnL in this market (USD, net of fees)
        - name: min_trades
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 1
              - type: 'null'
            description: Minimum trades in this market
            title: Min Trades
          description: Minimum trades in this market
        - name: max_trades
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 1
              - type: 'null'
            description: Maximum trades in this market
            title: Max Trades
          description: Maximum trades in this market
        - name: min_volume
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
            description: Minimum volume in this market
            title: Min Volume
          description: Minimum volume in this market
        - name: max_volume
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
            description: Maximum volume in this market
            title: Max Volume
          description: Maximum volume in this market
        - name: min_avg_buy_price
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: 0
              - type: 'null'
            description: Minimum avg buy price (0-1)
            title: Min Avg Buy Price
          description: Minimum avg buy price (0-1)
        - name: max_avg_buy_price
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: 0
              - type: 'null'
            description: Maximum avg buy price (0-1)
            title: Max Avg Buy Price
          description: Maximum avg buy price (0-1)
        - name: min_avg_sell_price
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: 0
              - type: 'null'
            description: Minimum avg sell price (0-1)
            title: Min Avg Sell Price
          description: Minimum avg sell price (0-1)
        - name: max_avg_sell_price
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: 0
              - type: 'null'
            description: Maximum avg sell price (0-1)
            title: Max Avg Sell Price
          description: Maximum avg sell price (0-1)
        - name: min_entry_edge
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: -1
              - type: 'null'
            description: Minimum entry edge (avg_sell - avg_buy)
            title: Min Entry Edge
          description: Minimum entry edge (avg_sell - avg_buy)
        - name: max_entry_edge
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: -1
              - type: 'null'
            description: Maximum entry edge (avg_sell - avg_buy)
            title: Max Entry Edge
          description: Maximum entry edge (avg_sell - avg_buy)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Results per page
            default: 100
            title: Limit
          description: Results per page
        - name: pagination_key
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Cursor for pagination
            title: Pagination Key
          description: Cursor for pagination
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketLeaderboardResponse'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Service Unavailable
components:
  schemas:
    TimeWindow:
      type: string
      enum:
        - 1d
        - 7d
        - 30d
        - all_time
      title: TimeWindow
      description: Time window for rolling metrics.
    LeaderboardSortBy:
      type: string
      enum:
        - realized_pnl
        - total_pnl
        - volume
        - roi
        - profit_factor
        - win_rate
        - trades
      title: LeaderboardSortBy
      description: Sort options for leaderboard.
    OrderDirection:
      type: string
      enum:
        - asc
        - desc
      title: OrderDirection
      description: Sort order direction enum.
    MarketLeaderboardResponse:
      properties:
        condition_id:
          type: string
          title: Condition Id
          description: Market condition ID
        window:
          $ref: '#/components/schemas/TimeWindow'
          description: Time window for metrics
        sort_by:
          $ref: '#/components/schemas/LeaderboardSortBy'
          description: Sort field used
        entries:
          items:
            $ref: '#/components/schemas/LeaderboardEntry'
          type: array
          title: Entries
          description: Leaderboard entries
        pagination:
          $ref: '#/components/schemas/CursorPagination'
          description: Pagination info
      type: object
      required:
        - condition_id
        - window
        - sort_by
        - entries
        - pagination
      title: MarketLeaderboardResponse
      description: Response for per-market leaderboard endpoint.
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
        message:
          type: string
          title: Message
      type: object
      required:
        - error
        - message
      title: ErrorResponse
      description: Standard error response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    LeaderboardEntry:
      properties:
        rank:
          type: integer
          title: Rank
          description: Position in leaderboard (1-indexed)
        user:
          type: string
          title: User
          description: Wallet address
        metrics:
          $ref: '#/components/schemas/WindowMetrics'
          description: Metrics for selected window
        trading_styles:
          $ref: '#/components/schemas/TradingStyleFlags'
          description: Trading style flags
        entry_edge:
          anyOf:
            - type: number
            - type: 'null'
          title: Entry Edge
          description: Price edge (avg_sell - avg_buy), only for all_time
        first_trade_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: First Trade At
          description: Unix timestamp of first trade
      type: object
      required:
        - rank
        - user
        - metrics
        - trading_styles
      title: LeaderboardEntry
      description: Single entry in the leaderboard.
    CursorPagination:
      properties:
        limit:
          type: integer
          title: Limit
          description: Requested limit
        count:
          type: integer
          title: Count
          description: Number of items in current response
        pagination_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Pagination Key
          description: Base64-encoded cursor for next page
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more items available
      type: object
      required:
        - limit
        - count
        - has_more
      title: CursorPagination
      description: Cursor-based pagination for endpoints that don't support offset.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    WindowMetrics:
      properties:
        realized_pnl:
          type: number
          title: Realized Pnl
          description: Realized profit/loss in USD (from closed positions)
        total_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Pnl
          description: Total PnL in USD (realized + unrealized - net fees)
        volume:
          type: number
          title: Volume
          description: Trading volume in USD
        roi:
          type: number
          title: Roi
          description: Return on investment (decimal, e.g., 0.5 = 50%)
        trades:
          type: integer
          title: Trades
          description: Number of trades
        wins:
          type: integer
          title: Wins
          description: Number of winning positions closed
        losses:
          type: integer
          title: Losses
          description: Number of losing positions closed
        win_rate:
          type: number
          title: Win Rate
          description: Win rate (decimal, e.g., 0.6 = 60%)
        profit_factor:
          type: number
          title: Profit Factor
          description: Profit factor (gross profit / gross loss)
        positions_closed:
          type: integer
          title: Positions Closed
          description: Number of positions closed
        avg_buy_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Buy Price
          description: Volume-weighted average buy price (0-1)
        avg_sell_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Sell Price
          description: Volume-weighted average sell price (0-1)
        fees_paid:
          type: number
          title: Fees Paid
          description: Taker fees paid in USD
          default: 0
        fees_refunded:
          type: number
          title: Fees Refunded
          description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
          default: 0
      type: object
      required:
        - realized_pnl
        - volume
        - roi
        - trades
        - wins
        - losses
        - win_rate
        - profit_factor
        - positions_closed
      title: WindowMetrics
      description: Metrics for a specific time window.
    TradingStyleFlags:
      properties:
        is_whale:
          type: boolean
          title: Is Whale
          description: Large position trader (avg trade > $1000)
        is_market_maker:
          type: boolean
          title: Is Market Maker
          description: Balanced buy/sell + frequent trading
        is_active_trader:
          type: boolean
          title: Is Active Trader
          description: High trade frequency (>4 trades/position)
        is_buy_and_hold:
          type: boolean
          title: Is Buy And Hold
          description: Long holding periods (<=2 trades/position)
        is_degen:
          type: boolean
          title: Is Degen
          description: High-risk pattern (win rate < 35%, 50+ closes)
        is_high_conviction:
          type: boolean
          title: Is High Conviction
          description: Buys at high YES prices (>=0.80)
        is_contrarian:
          type: boolean
          title: Is Contrarian
          description: Takes unpopular sides (<=0.25)
        is_value_hunter:
          type: boolean
          title: Is Value Hunter
          description: Enters at uncertain odds (0.35-0.55)
        primary_style:
          type: string
          title: Primary Style
          description: Primary trading style classification
      type: object
      required:
        - is_whale
        - is_market_maker
        - is_active_trader
        - is_buy_and_hold
        - is_degen
        - is_high_conviction
        - is_contrarian
        - is_value_hunter
        - primary_style
      title: TradingStyleFlags
      description: Multi-label trading style classification.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````