Home · APIs · Gaming · Chess.com player

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

FieldTypeValue in the sample
platformstringchess.com
usernamestringhikaru
titlestringGM
namestringHikaru Nakamura
countrystringUS
locationstringFlorida
joined_datestring2014-01-06
last_onlinestring2026-11-20
is_streamerbooleantrue
verifiedbooleanfalse
leaguestringLegend
followersnumber1436349
bulletobject{"current_rating":3402,"best_rating":3570,"best_game_url":"https://www.chess.com/game/live/5710095242","win...
blitzobject{"current_rating":3465,"best_rating":3503,"best_game_url":"https://www.chess.com/game/live/184580310677","w...
rapidobject{"current_rating":2838,"best_rating":2927,"best_game_url":"https://www.chess.com/game/live/141332265952","w...
dailyobject{"current_rating":2239,"best_rating":2464,"best_game_url":"https://www.chess.com/game/daily/84604826","wins...
chess960_dailyobject{"current_rating":1231,"best_rating":1489,"best_game_url":"https://www.chess.com/game/daily/87191830","wins...
tactics_ratingnumber2730
puzzle_rush_bestnumber123
profile_urlstringhttps://www.chess.com/member/Hikaru
avatarstringhttps://images.chesscomfiles.com/uploads/v1/user/15448422.88c010c1.200x200o.3c5619f5441e.png
time_controls_glossaryobject{"bullet":"1-2 minutes per game","blitz":"3-5 minutes per game","rapid":"10-25 minutes per game","daily":"1...
credits_usednumber1
latency_msnumber214

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"}'
import requests

r = requests.post(
    "https://api.foxapis.com/v1/gaming/chess/player",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"username":"hikaru"},
)
print(r.json())
const r = await fetch("https://api.foxapis.com/v1/gaming/chess/player", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"username":"hikaru"}),
});
console.log(await r.json());

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

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

Same category: Gaming · all APIs

How we calculate

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.