org.lichess.puzzle.getLeaderboard

pds.dad

Documentation

The ranked leaderboard, best rating first. Only established players appear: provisional ratings (high deviation), players with too few rated attempts, and players currently limited from ranked play are excluded.

main query

The ranked leaderboard, best rating first. Only established players appear: provisional ratings (high deviation), players with too few rated attempts, and players currently limited from ranked play are excluded.

Parameters

limit integer Optional

Maximum number of entries to return.

Output

Encodingapplication/json
entries array Required

Leaderboard entries ordered by rating, best first.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Maximum number of entries to return.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "entries"
      ],
      "properties": {
        "entries": {
          "type": "array",
          "items": {
            "ref": "org.lichess.puzzle.getLeaderboard#entry",
            "type": "ref"
          },
          "description": "Leaderboard entries ordered by rating, best first."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1,
        "description": "Maximum number of entries to return."
      }
    }
  },
  "description": "The ranked leaderboard, best rating first. Only established players appear: provisional ratings (high deviation), players with too few rated attempts, and players currently limited from ranked play are excluded."
}
entry object

One player's standing on the leaderboard.

Properties

avatar string uri Optional

URL of the player's avatar image, if they have one.

did string did Required

The player's atproto DID.

handle string handle Optional

The player's atproto handle, if resolvable.

nb integer Required

Number of rated puzzle attempts.

rating integer Required

The player's Glicko-2 rating, rounded.

ratingDeviation integer Required

The player's Glicko-2 rating deviation, rounded.

View raw schema 
{
  "type": "object",
  "required": [
    "did",
    "rating",
    "ratingDeviation",
    "nb"
  ],
  "properties": {
    "nb": {
      "type": "integer",
      "description": "Number of rated puzzle attempts."
    },
    "did": {
      "type": "string",
      "format": "did",
      "description": "The player's atproto DID."
    },
    "avatar": {
      "type": "string",
      "format": "uri",
      "description": "URL of the player's avatar image, if they have one."
    },
    "handle": {
      "type": "string",
      "format": "handle",
      "description": "The player's atproto handle, if resolvable."
    },
    "rating": {
      "type": "integer",
      "description": "The player's Glicko-2 rating, rounded."
    },
    "ratingDeviation": {
      "type": "integer",
      "description": "The player's Glicko-2 rating deviation, rounded."
    }
  },
  "description": "One player's standing on the leaderboard."
}

Lexicon Garden

@