v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Analysis

Get cloud evaluation of a position.

Get the cached evaluation of a position, if available. Opening positions have more chances of being available. There are about 320 million positions in the database. Up to 5 variations may be available. Variants are supported. Use this endpoint to fetch a few positions here and there. If you want to download a lot of positions, get the full list from our exported database.

get/api/cloud-eval

Query parameters

fenstring required

X-FEN of the position

multiPvinteger

Number of variations

variant'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'
Example:standard

Variant

Response

The evaluation of the position.

depthinteger required
fenstring required
knodesinteger required

Example response

{
  "fen": "r1bqkbnr/pppp1ppp/2n5/1B2p3/4P3/5N2/PPPP1PPP/RNBQK2R",
  "knodes": 106325,
  "depth": 29,
  "pvs": [
    {
      "moves": "d1e2 d8e7 a2a4 a7a6 b5c4 d7d6 d2d3 g8f6 c1e3 c6a5",
      "cp": 41
    },
    {
      "moves": "c2c3 a7a6 b5a4 g8f6 d2d3 b7b5 a4b3 h7h6 a2a4 c8b7",
      "cp": 39
    },
    {
      "moves": "d2d3 d8f6 c2c3 a7a6 b5a4 f8c5 d3d4 c5a7 c1e3 g8e7",
      "cp": 37
    }
  ]
}