Polymarket Smart-Wallet Leaderboard (All-Time PnL Rank)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "window",
    "sort_by",
    "entries",
    "pagination"
  ],
  "properties": {
    "window": {
      "type": "string",
      "description": "The time window the ranking covers, e.g. 'all_time'."
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "user",
          "metrics",
          "trading_styles",
          "entry_edge",
          "first_trade_at"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "1-indexed position in this ranking."
          },
          "user": {
            "type": "string",
            "description": "The wallet address this leaderboard entry belongs to (a 0x-prefixed hex string) -- the identifier the ranking is reporting on, not a person's contact detail."
          },
          "metrics": {
            "type": "object",
            "required": [
              "realized_pnl",
              "total_pnl",
              "volume",
              "roi",
              "trades",
              "wins",
              "losses",
              "win_rate",
              "profit_factor",
              "positions_closed",
              "avg_buy_price",
              "avg_sell_price",
              "fees_paid",
              "fees_refunded"
            ],
            "properties": {
              "roi": {
                "type": "number",
                "description": "Return on investment as a decimal fraction."
              },
              "wins": {
                "type": "integer",
                "description": "Number of winning closed positions."
              },
              "losses": {
                "type": "integer",
                "description": "Number of losing closed positions."
              },
              "trades": {
                "type": "integer",
                "description": "Total number of trades."
              },
              "volume": {
                "type": "number",
                "description": "USD, total traded volume."
              },
              "win_rate": {
                "type": "number",
                "description": "Decimal fraction, 0-1."
              },
              "fees_paid": {
                "type": "number",
                "description": "USD."
              },
              "total_pnl": {
                "type": "number",
                "description": "USD, realized plus unrealized profit/loss; the ranking's own sort key."
              },
              "realized_pnl": {
                "type": "number",
                "description": "USD, closed-position profit/loss."
              },
              "avg_buy_price": {
                "type": "number",
                "description": "Average entry price, 0-1 (a share-price probability)."
              },
              "fees_refunded": {
                "type": "number",
                "description": "USD."
              },
              "profit_factor": {
                "type": "number",
                "description": "Gross wins divided by gross losses. Observed as 0 on several entries with zero recorded losses -- not a signal of poor performance in that case."
              },
              "avg_sell_price": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Average exit price, 0-1. Observed null on several entries (positions resolved rather than sold, e.g. held to market settlement) -- not always present."
              },
              "positions_closed": {
                "type": "integer"
              }
            },
            "additionalProperties": false
          },
          "entry_edge": {
            "type": [
              "number",
              "null"
            ],
            "description": "Decimal fraction estimating the wallet's average entry-price edge versus fair value; observed null on many entries (edge not computable for that wallet's trade history) and as both positive and negative numbers elsewhere -- not always present."
          },
          "first_trade_at": {
            "type": "integer",
            "description": "Unix timestamp (seconds) of the wallet's first observed trade."
          },
          "trading_styles": {
            "type": "object",
            "required": [
              "is_active_trader",
              "is_buy_and_hold",
              "is_contrarian",
              "is_degen",
              "is_high_conviction",
              "is_market_maker",
              "is_value_hunter",
              "is_whale",
              "primary_style"
            ],
            "properties": {
              "is_degen": {
                "type": "boolean"
              },
              "is_whale": {
                "type": "boolean"
              },
              "is_contrarian": {
                "type": "boolean"
              },
              "primary_style": {
                "type": "string",
                "description": "Observed values: 'WHALE', 'ACTIVE_TRADER', 'UNKNOWN' -- other values are plausible but unconfirmed."
              },
              "is_buy_and_hold": {
                "type": "boolean"
              },
              "is_market_maker": {
                "type": "boolean"
              },
              "is_value_hunter": {
                "type": "boolean"
              },
              "is_active_trader": {
                "type": "boolean"
              },
              "is_high_conviction": {
                "type": "boolean"
              }
            },
            "description": "Boolean classification flags plus one dominant label; not mutually exclusive as booleans (an entry can carry several `true` flags), but `primary_style` is one value.",
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "description": "Ranked wallet entries (typically 100), best-performing first."
    },
    "sort_by": {
      "type": "string",
      "description": "The metric entries are ranked by, e.g. 'total_pnl'."
    },
    "pagination": {
      "type": "object",
      "required": [
        "count",
        "limit",
        "has_more"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "Number of entries returned (typically 100)."
        },
        "limit": {
          "type": "integer",
          "description": "Page size the source endpoint used (typically 100)."
        },
        "has_more": {
          "type": "boolean",
          "description": "Typically true -- the full leaderboard extends past this call's 100 entries, but this tool has no way to request the next page."
        }
      },
      "description": "Informational only -- this tool takes no input, so `pagination_key` cannot be sent back in a further call and is not exposed here.",
      "additionalProperties": false
    }
  },
  "description": "The leaderboard record.",
  "additionalProperties": false
}