Chess.com recent games API

Chess.com player's recent games for a month, oriented to the player (color, my rating, my result, opponent), normalized from the keyless Published-Data monthly archive. Answers queries like 'recent games of a chess.com player', 'did they win their last game', 'what openings is this player using'.

Price$0.01per request

MethodPOST

Route/v1/data/sports-chess-games

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

sportschesschesscomgamesarchiveplayeropeningsesports

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

Integration docs

Example request

{
  "username": "hikaru",
  "year": 2024,
  "month": 1,
  "limit": 20
}

Example response

{
  "username": "hikaru",
  "gameCount": 20,
  "games": [
    {
      "url": "https://www.chess.com/game/live/97872578329",
      "timeClass": "blitz",
      "rules": "chess",
      "rated": true,
      "endTime": "2024-01-01T18:28:26.000Z",
      "eco": "B01",
      "color": "white",
      "myRating": 3236,
      "myResult": "win",
      "opponent": "Gravity_Chess",
      "opponentRating": 2900
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "examples": [
        "hikaru"
      ]
    },
    "year": {
      "type": [
        "number",
        "string"
      ],
      "examples": [
        2024
      ]
    },
    "month": {
      "type": [
        "number",
        "string"
      ],
      "examples": [
        1
      ]
    },
    "limit": {
      "type": "number",
      "examples": [
        20
      ]
    }
  }
}

Output schema

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