Lichess user profile + ratings API

Lichess public user profile with title, join/last-seen times, total W-L-D, and per-variant (bullet/blitz/rapid/classical/correspondence) ratings, normalized from the keyless Lichess API. Answers queries like 'lichess rating of a user', 'how many games has X played', 'blitz rating on lichess'.

Price$0.01per request

MethodPOST

Route/v1/data/sports-lichess-user

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

sportschesslichessratingplayerprofileeloesports

API URLhttps://x402.hexl.dev/v1/data/sports-lichess-user

Integration docs

Example request

{
  "username": "DrNykterstein"
}

Example response

{
  "id": "drnykterstein",
  "username": "DrNykterstein",
  "title": "GM",
  "patron": true,
  "url": "https://lichess.org/@/DrNykterstein",
  "createdAt": "2016-05-18T19:25:42.000Z",
  "lastSeen": "2023-11-14T22:13:20.000Z",
  "playTimeSeconds": 5400000,
  "totals": {
    "games": 10450,
    "rated": 10435,
    "wins": 7207,
    "losses": 2409,
    "draws": 834
  },
  "ratings": {
    "bullet": {
      "games": 9583,
      "rating": 3243,
      "provisional": false,
      "progression": -14
    },
    "blitz": {
      "games": 606,
      "rating": 3153,
      "provisional": true,
      "progression": 37
    },
    "rapid": null,
    "classical": null,
    "correspondence": null
  }
}

Input schema

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "examples": [
        "DrNykterstein"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}