Lichess player API
One request, one key: POST /v1/gaming/lichess/player. The sample below is a real response captured 20 November 2026, shortened for display (long text cut, lists cut to three items); it is not invented.
Price
1 credit a call. One call is about $0.0098 and 1,000 calls are about $9.80 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.
Try it free
Runs one real call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"username": "DrNykterstein"
}
What it returns
| Field | Type | Value in the sample |
|---|---|---|
platform | string | lichess |
username | string | DrNykterstein |
title | string | GM |
patron | boolean | true |
online | boolean | false |
ultra_bullet | object | {"rating":2406,"games":92,"progress":-7,"provisional":true} |
bullet | object | {"rating":3263,"games":9585,"progress":23,"provisional":false} |
blitz | object | {"rating":3194,"games":609,"progress":70,"provisional":true} |
rapid | object | {"rating":2500,"games":0,"progress":0,"provisional":true} |
classical | object | {"rating":2500,"games":0,"progress":0,"provisional":true} |
correspondence | object | {"rating":1500,"games":0,"progress":0,"provisional":true} |
total_games | number | 10455 |
total_rated | number | 10440 |
total_wins | number | 7212 |
total_losses | number | 2409 |
total_draws | number | 834 |
play_time_hours | number | 325.1 |
created_date | string | 2018-12-06 |
last_seen_date | string | 2026-11-15 |
lichess_url | string | https://lichess.org/@/DrNykterstein |
time_controls_glossary | object | {"ultra_bullet":"Under 30 seconds per game","bullet":"1-2 minutes per game","blitz":"3-5 minutes per game",... |
credits_used | number | 1 |
latency_ms | number | 276 |
Sample response (20 November 2026)
{
"platform": "lichess",
"username": "DrNykterstein",
"title": "GM",
"patron": true,
"online": false,
"ultra_bullet": {
"rating": 2406,
"games": 92,
"progress": -7,
"provisional": true
},
"bullet": {
"rating": 3263,
"games": 9585,
"progress": 23,
"provisional": false
},
"blitz": {
"rating": 3194,
"games": 609,
"progress": 70,
"provisional": true
},
"rapid": {
"rating": 2500,
"games": 0,
"progress": 0,
"provisional": true
},
"classical": {
"rating": 2500,
"games": 0,
"progress": 0,
"provisional": true
},
"correspondence": {
"rating": 1500,
"games": 0,
"progress": 0,
"provisional": true
},
"puzzle": null,
"total_games": 10455,
"total_rated": 10440,
"total_wins": 7212,
"total_losses": 2409,
"total_draws": 834,
"completion_rate": null,
"play_time_hours": 325.1,
"created_date": "2018-12-06",
"last_seen_date": "2026-11-15",
"country": null,
"bio": null,
"fide_rating": null,
"lichess_url": "https://lichess.org/@/DrNykterstein",
"time_controls_glossary": {
"ultra_bullet": "Under 30 seconds per game",
"bullet": "1-2 minutes per game",
"blitz": "3-5 minutes per game",
"rapid": "8-25 minutes per game",
"classical": "25+ minutes per game",
"correspondence": "Days per move"
},
"errors": [],
"credits_used": 1,
"latency_ms": 276
}
Measured on that call: 833 ms.
Code
curl -X POST https://api.foxapis.com/v1/gaming/lichess/player \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"DrNykterstein"}'n8n (HTTP Request node: paste it into a workflow)
{
"nodes": [
{
"name": "Lichess player",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.foxapis.com/v1/gaming/lichess/player",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_KEY"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"username\":\"DrNykterstein\"}"
}
}
],
"connections": {}
}Assistants (Claude, ChatGPT, Cursor)
Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.
claude mcp add --transport http foxapis https://foxapis.com/mcp \ --header "Authorization: Bearer YOUR_KEY"
Errors and limits
- 401: the key is missing or wrong.
- 402: out of credits; top up on the pricing page.
- 422: the input does not match; the answer names the field.
- 429: too many calls too fast; wait a moment and try again.
- 503: the source did not answer; nothing is charged. Live state: status.
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keySame category: Gaming · all APIs
How we calculate
- Price of one call and of 1,000 calls: The credits per call times the smallest paid plan's price per credit (its monthly price divided by its monthly credits), times 1,000 for the larger figure.
Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.