Leaderboard

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.liquity.org/schemas/leaderboard.json",
  "title": "Leaderboard",
  "description": "Paginated leaderboard of Ethereum addresses ranked by accumulated Liquity protocol points.",
  "type": "object",
  "properties": {
    "total_row_count": {
      "type": "integer",
      "description": "Total number of entries in the full leaderboard.",
      "example": 1907
    },
    "rows": {
      "type": "array",
      "description": "List of leaderboard entries sorted by rank ascending.",
      "items": {
        "$ref": "#/$defs/LeaderboardEntry"
      }
    }
  },
  "required": ["total_row_count", "rows"],
  "$defs": {
    "LeaderboardEntry": {
      "type": "object",
      "title": "LeaderboardEntry",
      "description": "A single entry in the Liquity points leaderboard.",
      "properties": {
        "rank": {
          "type": "integer",
          "description": "Leaderboard ranking position (1-indexed).",
          "minimum": 1,
          "example": 1
        },
        "address": {
          "type": "string",
          "description": "Ethereum wallet address.",
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "example": "0xc83aa8e0da4ffc388fdbfc1cb111d8d625b5b8e7"
        },
        "points": {
          "type": "number",
          "description": "Total Liquity points accumulated by this address.",
          "example": 632014.0793235414
        },
        "percent": {
          "type": "number",
          "description": "Percentage share of total points distributed, expressed as a decimal between 0 and 1.",
          "minimum": 0,
          "maximum": 1,
          "example": 0.05085206108535175
        }
      },
      "required": ["rank", "address", "points", "percent"]
    }
  }
}