{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-leaderboard-entry-schema.json",
  "title": "LeaderboardEntry",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-leaderboard-api-openapi.yml#/components/schemas/LeaderboardEntry",
  "type": "object",
  "required": [
    "id",
    "address",
    "platform"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "username": {
      "type": "string"
    },
    "grade": {
      "type": "string"
    },
    "streak_tier": {
      "type": "string",
      "enum": [
        "hot",
        "rising",
        "neutral",
        "cooling",
        "cold"
      ],
      "description": "Hot-streak tier (trailing-7d cross-sectional percentile); a separate axis from the all-time grade. Omitted when there is no recent activity."
    },
    "score": {
      "type": "number"
    },
    "pnl": {
      "type": "number",
      "deprecated": true,
      "x-never-sent": true,
      "description": "Deprecated since 2026-10-27 and never sent. It was Polymarket's all-time leaderboard P&L, which covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl."
    },
    "realized_pnl": {
      "type": "number",
      "deprecated": true,
      "x-never-sent": true,
      "description": "Deprecated since 2026-10-27 and never sent. It was native Polymarket realized P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl."
    },
    "pnl_correction": {
      "$ref": "#/$defs/PnlCorrection",
      "deprecated": true,
      "x-never-sent": true,
      "description": "Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide realized_pnl (#29971). Its sports and esports part is inside in_scope.realized_pnl."
    },
    "volume": {
      "type": "number",
      "deprecated": true,
      "x-never-sent": true,
      "description": "Deprecated since 2026-10-27 and never sent. It was full-history USD cash volume over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971)."
    },
    "markets_traded": {
      "type": "integer",
      "description": "Sports and esports markets on the wallet's record, the same count as in_scope.markets. Since 2026-10-27 (#29971); before, it counted every Polymarket market. Sent exactly when in_scope is."
    },
    "win_rate": {
      "type": "number",
      "description": "The wallet's sports and esports win rate, in_scope.win_rate rounded to four places. Since 2026-10-27 (#29971); before, it covered every Polymarket market. ?category= decides WHICH wallets are listed (the wallet must be ranked in that category); it does not rescope this field. For a per-category record use GET /api/v1/trader/{address}/categories. Omitted when in_scope is omitted or has no win rate."
    },
    "in_scope": {
      "$ref": "#/$defs/TraderPnlInScope",
      "description": "Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero."
    },
    "strategy_type": {
      "type": "string",
      "description": "Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified, counted over the wallet's sports and esports markets only. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent."
    },
    "platform": {
      "type": "string",
      "enum": [
        "polymarket"
      ],
      "description": "Provider platform. Always polymarket."
    },
    "last_active": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "PnlCorrection": {
      "type": "object",
      "required": [
        "basis",
        "amount",
        "as_of",
        "markets_measured"
      ],
      "description": "A derived 0xinsider correction to Polymarket's P&L, never a Polymarket value. Polymarket misbooks neg-risk conversions, in both directions: it puts cost on placeholder YES outcomes minted by a conversion and never books it as a loss (negative amount), and its position records leave out shares the wallet really got, such as YES minted by a conversion, so it books no P&L on them (positive amount). Per neg-risk market the wallet converted in, 0xinsider measures Polymarket's own activity cash against the sum of its position P&L, and sums the difference over every measured market whose shares did not move by direct transfer: transferred shares have no activity row, so such a market keeps Polymarket's figure and is counted in markets_excluded. It is published once every neg-risk market with a sports or esports event that the wallet converted in is measured and checked for transfers, and stays as last published until then; a market with no sports or esports event is not measured, and counts only when it was measured before (on the trader body, pnl.correction_pending says so); a sum under $1 either way publishes nothing. The body's own P&L fields keep Polymarket's figures; this object adds the amount and the corrected figures. Money is truncated toward zero to cents.",
      "properties": {
        "basis": {
          "type": "string",
          "enum": [
            "neg_risk_conversion_v1"
          ],
          "description": "The correction method."
        },
        "amount": {
          "type": "number",
          "description": "The correction in USD. Negative when Polymarket overstates the wallet."
        },
        "realized": {
          "type": "number",
          "description": "Polymarket's net realized P&L plus amount. Since 2026-10-22 the grade reads this figure's sports and esports share. Omitted when Polymarket's figure is."
        },
        "net_total": {
          "type": "number",
          "description": "Polymarket's net total P&L over every Polymarket market of the wallet, plus amount. Omitted when Polymarket's figure is, and on leaderboard entries."
        },
        "as_of": {
          "type": "string",
          "format": "date-time",
          "description": "The newest measurement among the measured markets."
        },
        "markets_measured": {
          "type": "integer",
          "description": "Neg-risk markets whose measurement amount sums."
        },
        "markets_excluded": {
          "type": "integer",
          "description": "Measured neg-risk markets left out because shares moved in or out of the wallet by direct transfer; they keep Polymarket's figure. Omitted when none."
        }
      }
    },
    "TraderPnlInScope": {
      "type": "object",
      "required": [
        "basis",
        "realized_pnl",
        "markets",
        "markets_resolved",
        "win_rate",
        "markets_out_of_scope",
        "as_of"
      ],
      "description": "A wallet's sports and esports record (#27311). basis names the rule behind realized_pnl (#29370): polymarket_sports_esports_v1 is Polymarket's own realized P&L for the wallet in its sports and esports categories, plus the wallet's maker and taker rebates apportioned by its sports and esports share of its Polymarket volume (by cost while Polymarket reports no overall volume) and the in-scope part of any published neg-risk conversion correction; sports_esports_split_v1, used until both of the wallet's category figures are confirmed, is Polymarket's published wallet-wide realized P&L (with any published correction) split into the part earned on sports and esports markets, with fees, refunds and rebates apportioned by cost. Refreshed after each wallet sync and each read of Polymarket's category leaderboards; as_of dates the market counts.",
      "properties": {
        "basis": {
          "type": "string",
          "description": "The rule behind realized_pnl: polymarket_sports_esports_v1 (Polymarket's sports and esports category figures plus apportioned rebates) or sports_esports_split_v1 (the published realized figure split by cost). A new value means the rule changed; compare figures only within one basis."
        },
        "realized_pnl": {
          "type": [
            "number",
            "null"
          ],
          "description": "Sports and esports realized P&L in USD, display-safe. null when the split basis has no published realized figure to split."
        },
        "markets": {
          "type": "integer",
          "description": "Sports and esports markets the wallet has traded, any status."
        },
        "markets_resolved": {
          "type": "integer",
          "description": "Of those, the markets that have resolved."
        },
        "win_rate": {
          "type": [
            "number",
            "null"
          ],
          "description": "Share of decided sports and esports markets the wallet won, 0 to 1. null with no decided market."
        },
        "markets_out_of_scope": {
          "type": "integer",
          "description": "The wallet's markets outside sports and esports, which 0xinsider no longer lists: those it still stores, those whose rows it deleted and counted, and those of other categories first traded since 2026-10-26, which it does not store and counts as the wallet syncs (#30165)."
        },
        "as_of": {
          "type": "string",
          "format": "date-time",
          "description": "When the record behind these figures was computed."
        }
      }
    }
  }
}