# Chess.com API: List top players

> Lists up to 50 top Chess.com players for a time control, in rank order, with ratings, game records and profile links. Puzzles rankings use puzzle scores.

Unofficial. Not affiliated with or endorsed by Chess.com.

- Page: https://fous.com/methods/chess.com/list-top-players
- Method: `chess.com/list_top_players`, version 1
- Website: chess.com
- Returns: rank, username, name, title, country, rating, wins, losses, draws, profile link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `max_results` | integer | no | `5` | Maximum number of ranked players, for example 10. Default 50. |
| `time_control` | string | no | `"rapid"` | Leaderboard category, for example blitz. One of "rapid", "blitz", "bullet", "daily", "puzzles". Default "blitz". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "max_results": 5,
  "time_control": "rapid"
}
```

Its output:

```json
{
  "players": [
    {
      "name": "Manu David",
      "rank": 1,
      "wins": 290,
      "draws": 16,
      "title": "FM",
      "losses": 37,
      "rating": 2966,
      "country": "India",
      "username": "ManuDavid2910",
      "profile_link": "https://www.chess.com/member/ManuDavid2910"
    },
    {
      "name": "Magnus Carlsen",
      "rank": 2,
      "wins": 199,
      "draws": 125,
      "title": "GM",
      "losses": 42,
      "rating": 2941,
      "country": "Norway",
      "username": "MagnusCarlsen",
      "profile_link": "https://www.chess.com/member/MagnusCarlsen"
    },
    {
      "name": "Andrey Gutov",
      "rank": 3,
      "wins": 157,
      "draws": 3,
      "title": "GM",
      "losses": 1,
      "rating": 2938,
      "country": "United States",
      "username": "GutovAndrey",
      "profile_link": "https://www.chess.com/member/GutovAndrey"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"chess.com/list_top_players","input":{"max_results":5,"time_control":"rapid"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the top 10 blitz players on chess.com with their ratings and profile links
- Who are the highest rated bullet players right now? List the top 25 with country and title
- I need a ranked list of the top 50 rapid chess players, including wins, losses and draws
- Give me the current top 15 puzzle rankings by puzzle score, with usernames and countries
- What does the daily chess leaderboard look like? Top 5 players please, with their real names if listed

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of ranked players, for example 10."
    },
    "time_control": {
      "enum": [
        "rapid",
        "blitz",
        "bullet",
        "daily",
        "puzzles"
      ],
      "type": "string",
      "default": "blitz",
      "description": "Leaderboard category, for example blitz."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "players"
  ],
  "properties": {
    "players": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "username",
          "name",
          "title",
          "country",
          "rating",
          "wins",
          "losses",
          "draws",
          "profile_link"
        ],
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Displayed full name, when available."
          },
          "rank": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Leaderboard position."
          },
          "wins": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Published win count, when available."
          },
          "draws": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Published draw count, when available."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Chess title, when available."
          },
          "losses": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Published loss count, when available."
          },
          "rating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Leaderboard rating or puzzle score."
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Displayed country name, when available."
          },
          "username": {
            "type": "string",
            "description": "Chess.com username."
          },
          "profile_link": {
            "type": "string",
            "description": "Player profile page."
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Chess.com API: Get player stats](https://fous.com/methods/chess.com/get-player-stats.md): Gets a Chess.com player's public profile, ratings and game records, best puzzle rating and Puzzle Rush best score from a username or member profile link.
- [Chess.com API: List recent games](https://fous.com/methods/chess.com/list-recent-games.md): Lists a Chess.com player's completed public games for a month, newest first, with results, ratings, opening and game links.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [atptour.com API: Get ATP singles rankings](https://fous.com/methods/atptour.com/get-rankings.md): Gets the ATP men's singles world rankings as of the latest published ranking date. Finds one ranked player by name, or returns up to 500 ranked players in rank order.
- [Roblox API: List top games](https://fous.com/methods/roblox.com/list-top-games.md): Lists ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
- [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
- [Steam API: List most played games](https://fous.com/methods/store.steampowered.com/list-most-played.md): Lists the games with the most players on Steam right now, with current and peak players and prices for a chosen country.
- [All Chess.com methods](https://fous.com/methods/chess.com.md)