Polymarket Trader Leaderboard (by PnL, Volume, or Trade Count)

{
  "type": "object",
  "required": [
    "sort_by"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Defaults to 20."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction. Defaults to \"desc\"."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. Defaults to 0."
    },
    "sort_by": {
      "enum": [
        "pnl",
        "volume",
        "trade_count"
      ],
      "type": "string",
      "description": "Ranking metric."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pnl": {
            "type": "number",
            "description": "Realized profit and loss. Observed both positive and negative."
          },
          "volume": {
            "type": "number",
            "description": "Total trading volume. Observed 0 for many low-activity traders."
          },
          "address": {
            "type": "string",
            "description": "The trader's public Polymarket wallet address (Ethereum-style hex), e.g. '0xe111180000d2663c0091e4f400237545b87b996b'. This is on-chain public data, not a personal mailing address."
          },
          "positions": {
            "type": "integer",
            "description": "Total positions taken."
          },
          "trade_count": {
            "type": "integer",
            "description": "Number of trades. Observed 0 for many low-activity traders."
          },
          "positions_won": {
            "type": "integer"
          },
          "positions_lost": {
            "type": "integer"
          },
          "positions_open": {
            "type": "integer",
            "description": "Positions still open."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per ranked trader, in the requested sort order and page."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "description": "Echoes the requested `limit`."
        },
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        },
        "offset": {
          "type": "integer",
          "description": "Echoes the requested `offset`."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The leaderboard page, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}