STOCKFISH 14–19Latest release: 19Explore engines ↗

`POST /v1/batch`

Queue up to 50 positions at depth 1–14 with 1–3 principal variations. Returns a job id; poll /jobs/{id} or stream /jobs/{id}/events.

Auth: Bearer API key (keyless allowed with limits on eval and bestmove)

Request body

Field	Type	Default	Notes
`engine`	string	latest	stockfish-14 through stockfish-19; pinned when queued
`path`	auto \| native \| wasm	auto
`options`	object		Version-specific options from GET /v1/engines
`fens` *	array
`depth`	integer		1 to 14
`multipv`	integer		1 to 3

curl JavaScript Python

curl -s https://stockfishapi.com/v1/batch \
  -H "Authorization: Bearer $STOCKFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch("https://stockfishapi.com/v1/batch", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.STOCKFISH_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://stockfishapi.com/v1/batch",
    headers={"Authorization": f"Bearer {os.environ['STOCKFISH_API_KEY']}"},
    json={},
)
data = r.json()

Responses

Status	Meaning
`202`	Queued job

Errors follow problem+json with next_action.