Chess.com player profile + ratings API

Chess.com player profile with title, country, follower count, join date, and per-format (blitz/bullet/rapid/daily) ratings and win-loss-draw records, normalized from the keyless Published-Data API. Answers queries like 'chess.com rating of hikaru', 'what title does this player hold', 'blitz record of a user'.

Price$0.01per request

MethodPOST

Route/v1/data/sports-chess-player

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

sportschesschesscomratingplayerprofileeloesports

API URLhttps://x402.hexl.dev/v1/data/sports-chess-player

Integration docs

Example request

{
  "username": "hikaru"
}

Example response

{
  "username": "hikaru",
  "name": "Hikaru Nakamura",
  "title": "GM",
  "country": "US",
  "followers": 1393457,
  "status": "premium",
  "joined": "2014-01-06T00:00:58.000Z",
  "url": "https://www.chess.com/member/Hikaru",
  "ratings": {
    "blitz": {
      "rating": 3236,
      "best": 3300,
      "wins": 5000,
      "losses": 1000,
      "draws": 500
    },
    "bullet": null,
    "rapid": null,
    "daily": {
      "rating": 2239,
      "best": 2464,
      "wins": 73,
      "losses": 11,
      "draws": 4
    }
  }
}

Input schema

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "examples": [
        "hikaru"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}