Lichess player profile by username - title, ratings and game counts per mode, best rati…
Lichess player profile by username - title, ratings and game counts per mode, best rating, win rate, hours played, account age and last seen
by Saylor Innovations Knowledge Base · verified provider · updated 2026-10-26
What it does
Lichess player profile by username - title, ratings and game counts per mode, best rating, win rate, hours played, account age and last seen
Tags: lichess player rating · lichess profile stats · chess blitz rating of a player · lichess win rate and games · is this lichess user
Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/saylorinnovations-api-chess-lichess.jsonfor the price and payment options. - Pay. Call
GET https://saylorinnovations.com/api/chess/lichess/{username}. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC or USDT or SOL on Base, Polygon, Arbitrum One, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.01 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Polygon, Arbitrum One, Solana
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Polygon eip155:137 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Arbitrum One eip155:42161 | USDC | $0.01 | 0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDT | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | SOL | $0.01 | 7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7 | 120s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"amount": "10000",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
"asset": "So11111111111111111111111111111111111111112",
"amount": "95830",
"amountUsd": 0.01,
"maxTimeoutSeconds": 120
}
]Schemas
Output schema (JSON Schema)
{
"type": "object",
"properties": {
"username": {
"type": "string",
"description": "Account username"
},
"title": {
"type": [
"string",
"null"
],
"description": "Title"
},
"created": {
"type": [
"string",
"null"
],
"description": "Account creation time (UTC)"
},
"last_seen": {
"type": [
"string",
"null"
],
"description": "Time the account was last seen online"
},
"hours_played": {
"type": [
"number",
"null"
],
"description": "Hours played"
},
"games": {
"type": "object",
"description": "Game counts: total, rated, wins, losses, draws",
"properties": {
"rated": {
"description": "Rated games played",
"type": [
"number",
"null"
]
},
"wins": {
"description": "Games won",
"type": [
"number",
"null"
]
},
"losses": {
"description": "Games lost",
"type": [
"number",
"null"
]
},
"draws": {
"description": "Games drawn",
"type": [
"number",
"null"
]
},
"total": {
"type": [
"number",
"null"
],
"description": "Total number of matching items"
},
"win_rate_percent": {
"type": [
"number",
"null"
],
"description": "Win rate, as a percentage"
}
}
},
"best_rating": {
"type": [
"object",
"null"
],
"properties": {
"games": {
"description": "Games played in the best-rated category",
"type": [
"number",
"null"
]
},
"provisional": {
"description": "True when the rating is still provisional",
"type": [
"boolean",
"null"
]
},
"mode": {
"type": [
"string",
"null"
],
"description": "Mode used"
},
"rating": {
"type": [
"number",
"null"
],
"description": "Rating"
},
"rating_deviation": {
"type": [
"number",
"null"
],
"description": "Rating deviation"
},
"recent_progress": {
"type": [
"number",
"null"
],
"description": "Recent progress"
}
},
"description": "Best rating"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"games": {
"description": "Games played in this category",
"type": [
"number",
"null"
]
},
"provisional": {
"description": "True when the rating is still provisional",
"type": [
"boolean",
"null"
]
},
"mode": {
"description": "Mode used"
},
"rating": {
"description": "Rating"
},
"rating_deviation": {
"description": "Rating deviation"
},
"recent_progress": {
"description": "Recent progress"
}
}
},
"description": "Ratings"
},
"url": {
"type": "string",
"description": "Canonical URL"
},
"source": {
"type": "string",
"description": "Data source the values come from"
},
"patron": {
"description": "True when the player is a Lichess patron",
"type": [
"boolean",
"null"
]
},
"online": {
"description": "True when the player is online now",
"type": [
"boolean",
"null"
]
},
"playing": {
"description": "True when the player is in a game now",
"type": [
"boolean",
"null"
]
},
"bio": {
"description": "Profile biography text"
},
"country": {
"description": "Country name"
}
},
"required": [
"username",
"ratings",
"games"
]
}Example shape — generated from the schema, not a captured live response
{
"username": "string",
"title": "string",
"created": "string",
"last_seen": "string",
"hours_played": 0,
"games": {
"rated": 0,
"wins": 0,
"losses": 0,
"draws": 0,
"total": 0,
"win_rate_percent": 0
},
"best_rating": {
"games": 0,
"provisional": true,
"mode": "string",
"rating": 0,
"rating_deviation": 0,
"recent_progress": 0
},
"ratings": [
{
"games": 0,
"provisional": true,
"mode": null,
"rating": null,
"rating_deviation": null,
"recent_progress": null
}
],
"url": "string",
"source": "string",
"patron": true,
"online": true,
"playing": true,
"bio": null,
"country": null
}Examples
curl "https://saylorinnovations.com/api/chess/lichess/{username}"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://saylorinnovations.com/api/chess/lichess/{username}");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://saylorinnovations.com/api/chess/lichess/{username}")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- Saylor Innovations Knowledge Base
- Endpoint
- https://saylorinnovations.com/api/chess/lichess/{username}
- Side effects
- Paid calls settle the advertised payment; see the provider contract for execution behavior.
- Machine-readable
/resources/saylorinnovations-api-chess-lichess.json