Chess.com

Chess player stats, chess games and chess rankings

Chess.com returns public player profiles, ratings, records, puzzle scores, top-player rankings, and completed public games for a selected month, defaulting to the current UTC month.

Get player stats

Get a Chess.com player’s public profile, ratings, game records, best puzzle rating and Puzzle Rush best score from a username or profile link. Unplayed time controls and unpublished values are null.

Your information

Username

Player’s Chess.com username or profile link, for example Hikaru or https://www.chess.com/member/Hikaru.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Magnus Carlsen

GMNo

Norway

magnuscarlsen

View Chess.com profile

Followers: 318,642
Joined: Aug 26, 2010
Last online: Sep 28, 2026

Ratings

Rapid

Current rating2,941

Best rating: 2,977
Best rating date: Feb 6, 2023
Wins: 135
Losses: 32
Draws: 110

Blitz

Current rating3,402

Best rating: 3,410
Best rating date: Jun 24, 2026
Wins: 4,942
Losses: 1,104
Draws: 838

Bullet

Current rating3,270

Best rating: 3,390
Best rating date: Mar 27, 2023
Wins: 1,519
Losses: 494
Draws: 222

Daily

Puzzle results

Best puzzle rating400

About the Chess.com tool

Chess.com (Chesscom) returns public player profiles, ratings, records, best puzzle ratings, and Puzzle Rush scores from a username or profile link.

List recent games returns completed public games for a username and selected month, with optional game speed and result limit.

List top players returns ranked players for a selected time control, with ratings, records, and profile links.

Built from chess.com. Last checked Sep 29, 2026.

Actions

Get player stats

1 credit

What you provide

Field	Type	Required	Description
Username`username`	Text	Required	Player’s Chess.com username or profile link, for example Hikaru or https://www.chess.com/member/Hikaru.Example: https://www.chess.com/member/MagnusCarlsen

What you get

Field	Type	Description
Blitz`blitz`	Details	Null when this time control has never been played.
Wins`blitz.wins`	Number	Example: 4942
Draws`blitz.draws`	Number	Example: 838
Losses`blitz.losses`	Number	Example: 1104
Best Rating`blitz.best_rating`	Number	Highest published rating.Example: 3410
Current Rating`blitz.current_rating`	Number	Most recently published rating.Example: 3402
Best Rating Date`blitz.best_rating_date`	Date	Date of highest published rating.Example: 2026-06-24
Daily`daily`	Details	Null when this time control has never been played.
Wins`daily.wins`	Number	Example: 73
Draws`daily.draws`	Number	Example: 4
Losses`daily.losses`	Number	Example: 11
Best Rating`daily.best_rating`	Number	Highest published rating.Example: 2464
Current Rating`daily.current_rating`	Number	Most recently published rating.Example: 2239
Best Rating Date`daily.best_rating_date`	Date	Date of highest published rating.Example: 2014-04-10
Rapid`rapid`	Details	Null when this time control has never been played.
Wins`rapid.wins`	Number	Example: 135
Draws`rapid.draws`	Number	Example: 110
Losses`rapid.losses`	Number	Example: 32
Best Rating`rapid.best_rating`	Number	Highest published rating.Example: 2977
Current Rating`rapid.current_rating`	Number	Most recently published rating.Example: 2941
Best Rating Date`rapid.best_rating_date`	Date	Date of highest published rating.Example: 2023-02-06
Title`title`	Text	Example: GM
Bullet`bullet`	Details	Null when this time control has never been played.
Wins`bullet.wins`	Number	Example: 1519
Draws`bullet.draws`	Number	Example: 222
Losses`bullet.losses`	Number	Example: 494
Best Rating`bullet.best_rating`	Number	Highest published rating.Example: 3390
Current Rating`bullet.current_rating`	Number	Most recently published rating.Example: 3270
Best Rating Date`bullet.best_rating_date`	Date	Date of highest published rating.Example: 2023-03-27
Country`country`	Text	Country name.Example: Norway
Username`username`	Text	Example: Magnuscarlsen
Followers`followers`	Number	Example: 318642
Is Streamer`is_streamer`	Yes or no	Example: No
Joined Date`joined_date`	Date	Example: 2010-08-26
Display Name`display_name`	Text	Example: Magnus Carlsen
Profile Link`profile_link`	Link	Example: https://www.chess.com/member/MagnusCarlsen
Last Online Date`last_online_date`	Date	Example: 2026-09-28
Avatar Image Link`avatar_image_link`	Text	Example: https://images.chesscomfiles.com/uploads/v1/user/3889224.121e2094.200x200o.361c…
Best Puzzle Rating`best_puzzle_rating`	Number	Example: 400
Puzzle Rush Best Score`puzzle_rush_best_score`	Number	Example: 123

Example result

For Username: https://www.chess.com/member/MagnusCarlsen

JSON

{
  "blitz": {
    "wins": 4942,
    "draws": 838,
    "losses": 1104,
    "best_rating": 3410,
    "current_rating": 3402,
    "best_rating_date": "2026-06-24"
  },
  "daily": null,
  "rapid": {
    "wins": 135,
    "draws": 110,
    "losses": 32,
    "best_rating": 2977,
    "current_rating": 2941,
    "best_rating_date": "2023-02-06"
  },
  "title": "GM",
  "bullet": {
    "wins": 1519,
    "draws": 222,
    "losses": 494,
    "best_rating": 3390,
    "current_rating": 3270,
    "best_rating_date": "2023-03-27"
  },
  "country": "Norway",
  "username": "magnuscarlsen",
  "followers": 318642,
  "is_streamer": false,
  "joined_date": "2010-08-26",
  "display_name": "Magnus Carlsen",
  "profile_link": "https://www.chess.com/member/MagnusCarlsen",
  "last_online_date": "2026-09-28",
  "avatar_image_link": "https://images.chesscomfiles.com/uploads/v1/user/3889224.121e2094.200x200o.361c2f8a59c2.jpg",
  "best_puzzle_rating": 400,
  "puzzle_rush_best_score": null
}

List recent games

1 credit

List a player’s games for a month, newest first, with results, ratings, opening and game links. Defaults to the current UTC month; only completed public games in the selected month are included.

What you provide

Field	Type	Required	Description
Month`month`	Text	Optional	Month of games in YYYY-MM, for example 2026-09. Defaults to the current UTC month.Example: 2026-09
Username`username`	Text	Required	Chess.com username, for example MagnusCarlsen.Example: Erik
Max Results`max_results`	Number	Optional	Maximum number of games, for example 50. Defaults to 50.Example: 2
Time Control`time_control`	Text	Optional	Game speed, for example blitz. Defaults to all.Example: Daily

What you get

Field	Type	Description
Games`games`	List
Pgn`games[].pgn`	Text
Color`games[].color`	Text	Example: Black
Rated`games[].rated`	Text	Example: Yes
Result`games[].result`	Text	Example: Loss
End Time`games[].end_time`	Date	Date and time the game ended in UTC.Example: 2026-09-28T23:06:15+00:00
Game Link`games[].game_link`	Text	Example: https://www.chess.com/game/daily/1035606720
How It Ended`games[].how_it_ended`	Text	Example: Resignation
Opening Name`games[].opening_name`	Text	Example: Modern Defense with 1 d4
Time Control`games[].time_control`	Text	Example: 1 day per move
Player Rating`games[].player_rating`	Number	Example: 1402
Opponent Rating`games[].opponent_rating`	Number	Example: 1289
Opponent Username`games[].opponent_username`	Text	Example: NorwegianViking82
Final Position Fen`games[].final_position_fen`	Text	Example: r1b1rnqb/pppk3p/6p1/4npB1/8/2N2BP1/PPP1P2P/2KRRNQ1 b - - 3 9

Example result

For Month: 2026-09, Username: Erik, Max Results: 2, Time Control: Daily

JSON

{
  "games": [
    {
      "pgn": "[Event \"Let's Play! - Chess960\"]\n[Site \"Chess.com\"]\n[Date \"2026.09.27\"]\n[Round \"-\"]\n[White \"NorwegianViking82\"]\n[Black \"erik\"]\n[Result \"1-0\"]\n[Variant \"Chess960\"]\n[SetUp \"1\"]\n[FEN \"rnbkrnqb/pppppppp/8…",
      "color": "black",
      "rated": "yes",
      "result": "loss",
      "end_time": "2026-09-28T23:06:15+00:00",
      "game_link": "https://www.chess.com/game/daily/1035606720",
      "how_it_ended": "resignation",
      "opening_name": "Modern Defense with 1 d4",
      "time_control": "1 day per move",
      "player_rating": 1402,
      "opponent_rating": 1289,
      "opponent_username": "NorwegianViking82",
      "final_position_fen": "r1b1rnqb/pppk3p/6p1/4npB1/8/2N2BP1/PPP1P2P/2KRRNQ1 b - - 3 9"
    },
    {
      "pgn": "[Event \"Let's Play! - Chess960\"]\n[Site \"Chess.com\"]\n[Date \"2026.09.19\"]\n[Round \"-\"]\n[White \"erik\"]\n[Black \"NorwegianViking82\"]\n[Result \"1-0\"]\n[Variant \"Chess960\"]\n[SetUp \"1\"]\n[FEN \"rqbknrnb/pppppppp/8…",
      "color": "white",
      "rated": "yes",
      "result": "win",
      "end_time": "2026-09-27T12:28:43+00:00",
      "game_link": "https://www.chess.com/game/daily/1031528548",
      "how_it_ended": "resignation",
      "opening_name": "Kings Fianchetto Opening",
      "time_control": "1 day per move",
      "player_rating": 1429,
      "opponent_rating": 1311,
      "opponent_username": "NorwegianViking82",
      "final_position_fen": "6r1/pp3r2/2p4P/3pBkP1/3P4/1P6/P2KP3/6R1 w - - 0 32"
    }
  ]
}

List top players

1 credit

List up to 50 top Chess.com players by time control, in rank order, with ratings, game records and profile links. Puzzles rankings use puzzle scores; records are shown where published.

What you provide

Field	Type	Required	Description
Max Results`max_results`	Number	Optional	Maximum number of ranked players, for example 10.Example: 10
Time Control`time_control`	Text	Optional	Leaderboard category, for example blitz.Example: Blitz

What you get

Field	Type	Description
Players`players`	List
Name`players[].name`	Text	Displayed full name, when available.Example: Hikaru Nakamura
Rank`players[].rank`	Number	Leaderboard position.Example: 1
Wins`players[].wins`	Number	Published win count, when available.Example: 37427
Draws`players[].draws`	Number	Published draw count, when available.Example: 4412
Title`players[].title`	Text	Chess title, when available.Example: GM
Losses`players[].losses`	Number	Published loss count, when available.Example: 5648
Rating`players[].rating`	Number	Leaderboard rating or puzzle score.Example: 3469
Country`players[].country`	Text	Displayed country name, when available.Example: United States
Username`players[].username`	Text	Chess.com username.Example: Hikaru
Profile Link`players[].profile_link`	Text	Player profile page.Example: https://www.chess.com/member/Hikaru

Example result

For Max Results: 10, Time Control: Blitz

JSON

{
  "players": [
    {
      "name": "Hikaru Nakamura",
      "rank": 1,
      "wins": 37427,
      "draws": 4412,
      "title": "GM",
      "losses": 5648,
      "rating": 3469,
      "country": "United States",
      "username": "Hikaru",
      "profile_link": "https://www.chess.com/member/Hikaru"
    },
    {
      "name": "Magnus Carlsen",
      "rank": 2,
      "wins": 5126,
      "draws": 850,
      "title": "GM",
      "losses": 1133,
      "rating": 3402,
      "country": "Norway",
      "username": "MagnusCarlsen",
      "profile_link": "https://www.chess.com/member/MagnusCarlsen"
    },
    {
      "name": "Ediz Gürel",
      "rank": 3,
      "wins": 3244,
      "draws": 644,
      "title": "GM",
      "losses": 2450,
      "rating": 3339,
      "country": "Turkey",
      "username": "gurelediz",
      "profile_link": "https://www.chess.com/member/gurelediz"
    }
  ]
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@chess-com",
  "visibility": "public",
  "operation": "get_player_stats",
  "version": 1,
  "input": {
    "username": "https://www.chess.com/member/MagnusCarlsen"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Compare player ratings and records across time controls
Review a player's recent games and openings
Filter recent games by month or game speed
Track top players by time control
Find ranked players' profile links and countries

Questions about Chess.com

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Chess.com tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a Chess.com account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from chess.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.