Lichess user profile snapshot: ratings per perf, country, title, online status, counts
Lichess user profile snapshot: ratings per perf, country, title, online status, counts.
1000 (raw units)
price
2
calls / 30d
1
unique payers
2026-08-25
updated
Provider
chess402.vercel.app · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xfbd46201267609ad3c66bd1b99b7f1cc80b1852f",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "1000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"username": "DrNykterstein"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"count": {
"all": 10450,
"draw": 2450,
"loss": 2000,
"rated": 9800,
"win": 6000
},
"createdAt": 1389027719000,
"id": "drnykterstein",
"online": false,
"patron": false,
"perfs": {
"blitz": {
"games": 1234,
"prog": 12,
"prov": false,
"rating": 3153,
"rd": 45
},
"bullet": {
"games": 5678,
"prog": -5,
"prov": false,
"rating": 3243,
"rd": 40
},
"rapid": {
"games": 89,
"prog": 0,
"prov": false,
"rating": 2881,
"rd": 60
}
},
"playTime": {
"total": 1234567,
"tv": 0
},
"profile": {
"flag": "NO"
},
"seenAt": 1700000000000,
"title": "GM",
"url": "https://lichess.org/@/DrNykterstein",
"username": "DrNykterstein"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Lichess user profile lookup.",
"properties": {
"username": {
"description": "Lichess username (case-insensitive).",
"maxLength": 30,
"minLength": 2,
"pattern": "^[A-Za-z0-9_-]+$",
"type": "string"
}
},
"required": [
"username"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"description": "Lichess user profile snapshot.",
"properties": {
"count": {
"additionalProperties": {},
"description": "Game count breakdown.",
"properties": {
"all": {
"description": "Total games.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"bookmark": {
"description": "Bookmarked games.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"draw": {
"description": "Draws.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"import": {
"description": "Imported games.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"loss": {
"description": "Losses.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rated": {
"description": "Rated games.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"win": {
"description": "Wins.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"all",
"rated",
"win",
"loss",
"draw"
],
"type": "object"
},
"createdAt": {
"description": "Account creation timestamp (ms epoch).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"flair": {
"description": "User flair emoji slug.",
"type": "string"
},
"id": {
"description": "Lowercase Lichess user id.",
"type": "string"
},
"online": {
"description": "Whether the user is online now.",
"type": "boolean"
},
"patron": {
"description": "Whether the user is a Lichess patron.",
"type": "boolean"
},
"perfs": {
"additionalProperties": {
"additionalProperties": {},
"properties": {
"games": {
"description": "Total games played.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"prog": {
"description": "Rating progression (last 12 games).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"prov": {
"description": "Whether the rating is provisional.",
"type": "boolean"
},
"rating": {
"description": "Current rating.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"rd": {
"description": "Rating deviation.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"games",
"rating"
],
"type": "object"
},
"description": "Per-variant performance objects keyed by perf name (bullet, blitz, rapid, classical, puzzle, …).",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"playTime": {
"additionalProperties": false,
"description": "Cumulative play time.",
"properties": {
"total": {
"description": "Total seconds played on Lichess.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"tv": {
"description": "Seconds streamed on Lichess TV.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"total",
"tv"
],
"type": "object"
},
"profile": {
"additionalProperties": {},
"description": "Free-form profile fields set by the user.",
"properties": {
"bio": {
"description": "User biography.",
"type": "string"
},
"firstName": {
"type": "string"
},
"flag": {
"description": "ISO 3166-1 alpha-2 country code.",
"type": "string"
},
"lastName": {
"type": "string"
},
"links": {
"description": "User-provided links.",
"type": "string"
}
},
"type": "object"
},
"seenAt": {
"description": "Last activity timestamp (ms epoch).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"title": {
"description": "FIDE title (GM, IM, FM, ...), if any.",
"type": "string"
},
"url": {
"description": "Lichess profile URL.",
"type": "string"
},
"username": {
"description": "Display username.",
"type": "string"
}
},
"required": [
"id",
"username"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://chess402.vercel.app/api/user" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://chess402.vercel.app/api/user");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://chess402.vercel.app/api/user")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/13033.json, and this resource appears in /discovery/resources and /discovery/search.