STOCKFISH 14–19Latest release: 19Explore engines ↗

Learn

Centipawn

The unit of a chess evaluation: 100 centipawns is one pawn of advantage.

Stockfish reports its evaluation in centipawns (cp). +100 means White is a pawn better in the engine's judgement; −250 means Black is two and a half pawns better. The number is from White's point of view in this API regardless of who is to move. Because modern engines (NNUE) scale scores so that +100 is roughly a 50% expected score advantage, treat the sign and rough magnitude as meaningful, not the second digit.

Example

♜♞♝♛♚♝♜♟♟♟♟♟♟♟♞♘♙♘♙♙♙♙♙♙♖♗♕♔♗♖
curl -s https://stockfishapi.com/v1/eval \
  -H "Authorization: Bearer $STOCKFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fen":"rnbqkb1r/1p2pppp/p2p1n2/8/3NP3/2N5/PPP2PPP/R1BQKB1R w KQkq - 0 6","depth":14}'
const res = await fetch("https://stockfishapi.com/v1/eval", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.STOCKFISH_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "fen": "rnbqkb1r/1p2pppp/p2p1n2/8/3NP3/2N5/PPP2PPP/R1BQKB1R w KQkq - 0 6",
    "depth": 14
  }),
});
const data = await res.json();
import os, requests

r = requests.post(
    "https://stockfishapi.com/v1/eval",
    headers={"Authorization": f"Bearer {os.environ['STOCKFISH_API_KEY']}"},
    json={
        "fen": "rnbqkb1r/1p2pppp/p2p1n2/8/3NP3/2N5/PPP2PPP/R1BQKB1R w KQkq - 0 6",
        "depth": 14
    },
)
data = r.json()