Chess.com player API
One request, one key: POST /v1/gaming/chess/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": "hikaru"
}
What it returns
| Field | Type | Value in the sample |
|---|---|---|
platform | string | chess.com |
username | string | hikaru |
title | string | GM |
name | string | Hikaru Nakamura |
country | string | US |
location | string | Florida |
joined_date | string | 2014-01-06 |
last_online | string | 2026-11-20 |
is_streamer | boolean | true |
verified | boolean | false |
league | string | Legend |
followers | number | 1436349 |
bullet | object | {"current_rating":3402,"best_rating":3570,"best_game_url":"https://www.chess.com/game/live/5710095242","win... |
blitz | object | {"current_rating":3465,"best_rating":3503,"best_game_url":"https://www.chess.com/game/live/184580310677","w... |
rapid | object | {"current_rating":2838,"best_rating":2927,"best_game_url":"https://www.chess.com/game/live/141332265952","w... |
daily | object | {"current_rating":2239,"best_rating":2464,"best_game_url":"https://www.chess.com/game/daily/84604826","wins... |
chess960_daily | object | {"current_rating":1231,"best_rating":1489,"best_game_url":"https://www.chess.com/game/daily/87191830","wins... |
tactics_rating | number | 2730 |
puzzle_rush_best | number | 123 |
profile_url | string | https://www.chess.com/member/Hikaru |
avatar | string | https://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png |
time_controls_glossary | object | {"bullet":"1-2 minutes per game","blitz":"3-5 minutes per game","rapid":"10-25 minutes per game","daily":"1... |
credits_used | number | 1 |
latency_ms | number | 214 |
Sample response (20 November 2026)
{
"platform": "chess.com",
"username": "hikaru",
"title": "GM",
"name": "Hikaru Nakamura",
"country": "US",
"location": "Florida",
"joined_date": "2014-01-06",
"last_online": "2026-11-20",
"is_streamer": true,
"verified": false,
"league": "Legend",
"followers": 1436349,
"bullet": {
"current_rating": 3402,
"best_rating": 3570,
"best_game_url": "https://www.chess.com/game/live/5710095242",
"wins": 17334,
"losses": 2562,
"draws": 1197,
"total_games": 21093,
"last_game_date": "2026-11-16"
},
"blitz": {
"current_rating": 3465,
"best_rating": 3503,
"best_game_url": "https://www.chess.com/game/live/184580310677",
"wins": 36259,
"losses": 5573,
"draws": 4397,
"total_games": 46229,
"last_game_date": "2026-11-19"
},
"rapid": {
"current_rating": 2838,
"best_rating": 2927,
"best_game_url": "https://www.chess.com/game/live/141332265952",
"wins": 205,
"losses": 69,
"draws": 220,
"total_games": 494,
"last_game_date": "2026-08-15"
},
"daily": {
"current_rating": 2239,
"best_rating": 2464,
"best_game_url": "https://www.chess.com/game/daily/84604826",
"wins": 73,
"losses": 11,
"draws": 4,
"total_games": 88,
"last_game_date": "2026-02-08"
},
"chess960_daily": {
"current_rating": 1231,
"best_rating": 1489,
"best_game_url": "https://www.chess.com/game/daily/87191830",
"wins": 1,
"losses": 2,
"draws": 0,
"total_games": 3,
"last_game_date": "2015-10-10"
},
"tactics_rating": 2730,
"puzzle_rush_best": 123,
"profile_url": "https://www.chess.com/member/Hikaru",
"avatar": "https://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png",
"time_controls_glossary": {
"bullet": "1-2 minutes per game",
"blitz": "3-5 minutes per game",
"rapid": "10-25 minutes per game",
"daily": "1-14 days per move (correspondence chess)"
},
"errors": [],
"credits_used": 1,
"latency_ms": 214
}
Measured on that call: 815 ms.
Code
curl -X POST https://api.foxapis.com/v1/gaming/chess/player \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"hikaru"}'n8n (HTTP Request node: paste it into a workflow)
{
"nodes": [
{
"name": "Chess.com player",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.foxapis.com/v1/gaming/chess/player",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_KEY"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"username\":\"hikaru\"}"
}
}
],
"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.