{
  "x402Version": 2,
  "id": 72271,
  "slug": "saylorinnovations-api-chess-lichess-top",
  "resource": "https://saylorinnovations.com/api/chess/lichess-top",
  "description": "Lichess leaderboard of top players by rating mode - bullet, blitz, rapid, classical, chess960 and variants with titles, ratings and recent progress",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "mode": {
        "type": "string",
        "description": "Mode used"
      },
      "count": {
        "type": "number",
        "description": "Number of items returned"
      },
      "leaderboard": {
        "type": "array",
        "description": "Top players in the category with rank, username, title, rating and progress",
        "items": {
          "type": "object",
          "properties": {
            "online": {
              "description": "True when the player is online",
              "type": [
                "boolean",
                "null"
              ]
            },
            "patron": {
              "description": "True when the player is a Lichess patron",
              "type": [
                "boolean",
                "null"
              ]
            },
            "rank": {
              "description": "Rank, 1 is highest"
            },
            "username": {
              "description": "Account username"
            },
            "title": {
              "description": "Title"
            },
            "rating": {
              "description": "Rating"
            },
            "recent_progress": {
              "description": "Recent progress"
            }
          }
        }
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      }
    },
    "required": [
      "mode",
      "leaderboard"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "count": "10",
            "perf": "blitz"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "mode": "blitz",
            "count": 10,
            "leaderboard": [
              {
                "rank": 1,
                "username": "cutemouse83",
                "title": "GM",
                "rating": 3002,
                "recent_progress": 15,
                "online": false,
                "patron": false
              },
              {
                "rank": 2,
                "username": "Savitar_f",
                "title": null,
                "rating": 2957,
                "recent_progress": -11,
                "online": false,
                "patron": false
              },
              {
                "rank": 3,
                "username": "Yarebore",
                "title": "GM",
                "rating": 2953,
                "recent_progress": 8,
                "online": false,
                "patron": false
              },
              {
                "rank": 4,
                "username": "Lintchevski_Daniil",
                "title": "GM",
                "rating": 2952,
                "recent_progress": 29,
                "online": false,
                "patron": false
              },
              {
                "rank": 5,
                "username": "Vladimirovich9000",
                "title": "GM",
                "rating": 2945,
                "recent_progress": 0,
                "online": false,
                "patron": false
              },
              {
                "rank": 6,
                "username": "Tuzakli_Egitim",
                "title": "FM",
                "rating": 2939,
                "recent_progress": -15,
                "online": false,
                "patron": false
              },
              {
                "rank": 7,
                "username": "Real_G13M37",
                "title": null,
                "rating": 2935,
                "recent_progress": 2,
                "online": false,
                "patron": false
              },
              {
                "rank": 8,
                "username": "Sunrise34",
                "title": null,
                "rating": 2934,
                "recent_progress": -19,
                "online": false,
                "patron": false
              },
              {
                "rank": 9,
                "username": "KnightlyInsight",
                "title": null,
                "rating": 2930,
                "recent_progress": -8,
                "online": false,
                "patron": false
              },
              {
                "rank": 10,
                "username": "Mlchael",
                "title": "IM",
                "rating": 2917,
                "recent_progress": 28,
                "online": false,
                "patron": false
              }
            ],
            "source": "Lichess"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "count": {
                    "type": "string",
                    "description": "optional 1-50, default 10"
                  },
                  "perf": {
                    "type": "string",
                    "description": "blitz (default), bullet, rapid, classical, ultraBullet, chess960, crazyhouse, atomic, horde, antichess, kingOfTheHill, racingKings, threeCheck"
                  }
                }
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "description": "Mode used"
                  },
                  "count": {
                    "type": "number",
                    "description": "Number of items returned"
                  },
                  "leaderboard": {
                    "type": "array",
                    "description": "Top players in the category with rank, username, title, rating and progress",
                    "items": {
                      "type": "object",
                      "properties": {
                        "online": {
                          "description": "True when the player is online",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "patron": {
                          "description": "True when the player is a Lichess patron",
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "rank": {
                          "description": "Rank, 1 is highest"
                        },
                        "username": {
                          "description": "Account username"
                        },
                        "title": {
                          "description": "Title"
                        },
                        "rating": {
                          "description": "Rating"
                        },
                        "recent_progress": {
                          "description": "Recent progress"
                        }
                      }
                    }
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  }
                },
                "required": [
                  "mode",
                  "leaderboard"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "top lichess blitz players",
    "chess leaderboard bullet rating",
    "highest rated rapid players",
    "who is number one in chess960",
    "lichess top 10 by mode"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.873Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "count": {
          "type": "string",
          "description": "optional 1-50, default 10"
        },
        "perf": {
          "type": "string",
          "description": "blitz (default), bullet, rapid, classical, ultraBullet, chess960, crazyhouse, atomic, horde, antichess, kingOfTheHill, racingKings, threeCheck"
        }
      },
      "required": []
    },
    "exampleResponse": {
      "mode": "blitz",
      "count": 10,
      "leaderboard": [
        {
          "rank": 1,
          "username": "cutemouse83",
          "title": "GM",
          "rating": 3002,
          "recent_progress": 15,
          "online": false,
          "patron": false
        },
        {
          "rank": 2,
          "username": "Savitar_f",
          "title": null,
          "rating": 2957,
          "recent_progress": -11,
          "online": false,
          "patron": false
        },
        {
          "rank": 3,
          "username": "Yarebore",
          "title": "GM",
          "rating": 2953,
          "recent_progress": 8,
          "online": false,
          "patron": false
        },
        {
          "rank": 4,
          "username": "Lintchevski_Daniil",
          "title": "GM",
          "rating": 2952,
          "recent_progress": 29,
          "online": false,
          "patron": false
        },
        {
          "rank": 5,
          "username": "Vladimirovich9000",
          "title": "GM",
          "rating": 2945,
          "recent_progress": 0,
          "online": false,
          "patron": false
        },
        {
          "rank": 6,
          "username": "Tuzakli_Egitim",
          "title": "FM",
          "rating": 2939,
          "recent_progress": -15,
          "online": false,
          "patron": false
        },
        {
          "rank": 7,
          "username": "Real_G13M37",
          "title": null,
          "rating": 2935,
          "recent_progress": 2,
          "online": false,
          "patron": false
        },
        {
          "rank": 8,
          "username": "Sunrise34",
          "title": null,
          "rating": 2934,
          "recent_progress": -19,
          "online": false,
          "patron": false
        },
        {
          "rank": 9,
          "username": "KnightlyInsight",
          "title": null,
          "rating": 2930,
          "recent_progress": -8,
          "online": false,
          "patron": false
        },
        {
          "rank": 10,
          "username": "Mlchael",
          "title": "IM",
          "rating": 2917,
          "recent_progress": 28,
          "online": false,
          "patron": false
        }
      ],
      "source": "Lichess"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "count": "10",
              "perf": "blitz"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "mode": "blitz",
              "count": 10,
              "leaderboard": [
                {
                  "rank": 1,
                  "username": "cutemouse83",
                  "title": "GM",
                  "rating": 3002,
                  "recent_progress": 15,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 2,
                  "username": "Savitar_f",
                  "title": null,
                  "rating": 2957,
                  "recent_progress": -11,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 3,
                  "username": "Yarebore",
                  "title": "GM",
                  "rating": 2953,
                  "recent_progress": 8,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 4,
                  "username": "Lintchevski_Daniil",
                  "title": "GM",
                  "rating": 2952,
                  "recent_progress": 29,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 5,
                  "username": "Vladimirovich9000",
                  "title": "GM",
                  "rating": 2945,
                  "recent_progress": 0,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 6,
                  "username": "Tuzakli_Egitim",
                  "title": "FM",
                  "rating": 2939,
                  "recent_progress": -15,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 7,
                  "username": "Real_G13M37",
                  "title": null,
                  "rating": 2935,
                  "recent_progress": 2,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 8,
                  "username": "Sunrise34",
                  "title": null,
                  "rating": 2934,
                  "recent_progress": -19,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 9,
                  "username": "KnightlyInsight",
                  "title": null,
                  "rating": 2930,
                  "recent_progress": -8,
                  "online": false,
                  "patron": false
                },
                {
                  "rank": 10,
                  "username": "Mlchael",
                  "title": "IM",
                  "rating": 2917,
                  "recent_progress": 28,
                  "online": false,
                  "patron": false
                }
              ],
              "source": "Lichess"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "string",
                      "description": "optional 1-50, default 10"
                    },
                    "perf": {
                      "type": "string",
                      "description": "blitz (default), bullet, rapid, classical, ultraBullet, chess960, crazyhouse, atomic, horde, antichess, kingOfTheHill, racingKings, threeCheck"
                    }
                  }
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string",
                      "description": "Mode used"
                    },
                    "count": {
                      "type": "number",
                      "description": "Number of items returned"
                    },
                    "leaderboard": {
                      "type": "array",
                      "description": "Top players in the category with rank, username, title, rating and progress",
                      "items": {
                        "type": "object",
                        "properties": {
                          "online": {
                            "description": "True when the player is online",
                            "type": [
                              "boolean",
                              "null"
                            ]
                          },
                          "patron": {
                            "description": "True when the player is a Lichess patron",
                            "type": [
                              "boolean",
                              "null"
                            ]
                          },
                          "rank": {
                            "description": "Rank, 1 is highest"
                          },
                          "username": {
                            "description": "Account username"
                          },
                          "title": {
                            "description": "Title"
                          },
                          "rating": {
                            "description": "Rating"
                          },
                          "recent_progress": {
                            "description": "Recent progress"
                          }
                        }
                      }
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    }
                  },
                  "required": [
                    "mode",
                    "leaderboard"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/chess/lichess-top?perf=blitz&count=10",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "mode": "string",
    "count": 0,
    "leaderboard": [
      {
        "online": true,
        "patron": true,
        "rank": null,
        "username": null,
        "title": null,
        "rating": null,
        "recent_progress": null
      }
    ],
    "source": "string"
  }
}