---
title: Go Position Analysis API
slug: analyze-go-position
url: https://apyhub.com/chensichengmalu/service/analyze-go-position
provider: Malu
categories: [Model Kit]
tags: [go, board-game, position-analysis, game-analysis, model-inference]
auth: api_key
version: 1.1.0
service_type: sync
endpoints: 1
atoms: 400
mcp: true
---

# Go Position Analysis API

Analyze a single Go position. Wrap fields in query. Requested search target: 16–1000 visits; actual engine visits, including parallel search overshoot, are repo

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/chensichengmalu/analyze-go-position` | What it does Analyses one Go position with the KataGo engine and returns the best candidate moves,… | 400 |

## Endpoint reference

### Analyze Go Position

`POST https://api.eu.apyhub.com/chensichengmalu/analyze-go-position` · 400 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query.id` | body | string | yes | Caller-provided printable query identifier. Example: `position-001`. |
| `query.komi` | body | number | no | White compensation, integer or half-integer. Default: `7.5`. Example: `7.5`. |
| `query.moves` | body | array of array | yes | Move history in order; pass is allowed. Example: `[["B","D4"],["W","Q16"]]`. |
| `query.rules` | body | string | yes | Scoring and ko ruleset — chinese, japanese, korean, aga (American Go Association), tromp-taylor, new-zealand, chinese-ogs (Chinese as played on OGS), stone-scoring, ancient-territory, bga (British Go… |
| `query.maxVisits` | body | integer | yes | Requested search target; actual visits can slightly exceed this with parallel search and are reported exactly in usage.visits. Example: `128`. |
| `query.boardXSize` | body | integer | yes | Board width in points, 2–19. Example: `19`. |
| `query.boardYSize` | body | integer | yes | Board height in points, 2–19. Example: `19`. |
| `query.includePolicy` | body | boolean | no | Return policy probabilities. Default: `false`. Example: `false`. |
| `query.initialPlayer` | body | string | no | Color to move before moves; set W for a handicap start when appropriate. One of: B, W. Default: `B`. Example: `B`. |
| `query.initialStones` | body | array of array | no | Setup stones before the move history; no pass or duplicate coordinates. Default: `[]`. Example: `[]`. |
| `query.includePVVisits` | body | boolean | no | Return visit counts along principal variations. Default: `false`. Example: `false`. |
| `query.includeOwnership` | body | boolean | no | Return root ownership array. Default: `false`. Example: `false`. |
| `query.includeMovesOwnership` | body | boolean | no | Return ownership per candidate move. Default: `false`. Example: `false`. |
| `query.includeOwnershipStdev` | body | boolean | no | Return root ownership standard deviations. Default: `false`. Example: `false`. |
| `query.includeMovesOwnershipStdev` | body | boolean | no | Return candidate ownership standard deviations. Default: `false`. Example: `false`. |

#### Quickstart

```bash
curl -X POST "https://api.eu.apyhub.com/chensichengmalu/analyze-go-position" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": {"id": "position-001", "moves": [["B", "D4"], ["W", "Q16"]], "initialStones": [], "initialPlayer": "B", "rules": "chinese", "komi": 7.5, "boardXSize": 19, "boardYSize": 19, "maxVisits": 128}}'
```

#### What you'll get back

A real response to the request above, with `moveInfos` cut to the top 2 of 25 candidates:

```json
{
  "id": "a67a2c30-e522-4786-b9ae-0f256530e8d9",
  "results": [
    {
      "id": "position-001",
      "isDuringSearch": false,
      "moveInfos": [
        {
          "edgeVisits": 23,
          "edgeWeight": 68.7274098,
          "lcb": 0.36006499,
          "move": "Q4",
          "order": 0,
          "playSelectionValue": 87.1032681,
          "prior": 0.148080483,
          "pv": [
            "Q4",
            "D16",
            "C14",
            "R3",
            "R4",
            "Q3",
            "P4",
            "O2",
            "O17"
          ],
          "scoreLead": -0.829977172,
          "scoreMean": -0.829977172,
          "scoreSelfplay": -1.47433381,
          "scoreStdev": 14.3836344,
          "utility": -0.271389663,
          "utilityLcb": -0.287650735,
          "visits": 23,
          "weight": 68.7274098,
          "winrate": 0.365872516
        },
        {
          "edgeVisits": 23,
          "edgeWeight": 68.7274098,
          "isSymmetryOf": "Q4",
          "lcb": 0.36006499,
          "move": "D16",
          "order": 1,
          "playSelectionValue": 87.1032681,
          "prior": 0.148080483,
          "pv": [
            "D16",
            "Q4",
            "O3",
            "C17",
            "D17",
            "C16",
            "D15",
            "B14",
            "R14"
          ],
          "scoreLead": -0.829977172,
          "scoreMean": -0.829977172,
          "scoreSelfplay": -1.47433381,
          "scoreStdev": 14.3836344,
          "utility": -0.271389663,
          "utilityLcb": -0.287650735,
          "visits": 23,
          "weight": 68.7274098,
          "winrate": 0.365872516
        }
      ],
      "rootInfo": {
        "currentPlayer": "B",
        "rawLead": -0.940142393,
        "rawNoResultProb": 0.00191160478,
        "rawScoreSelfplay": -1.77044725,
        "rawScoreSelfplayStdev": 15.7489616,
        "rawStScoreError": 0.430892259,
        "rawStWrError": 0.0235168915,
        "rawVarTimeLeft": 55.916153,
        "rawWinrate": 0.359518915,
        "scoreLead": -0.837885744,
        "scoreSelfplay": -1.51583622,
        "scoreStdev": 14.2091842,
        "symHash": "3862C0A608F2A84E883950EFC2AF0DC8",
        "thisHash": "61716259BD714312DC16933A804034BD",
        "utility": -0.274976737,
        "visits": 135,
        "weight": 408.61688680863534,
        "winrate": 0.364717179
      },
      "turnNumber": 2
    }
  ],
  "usage": {
    "visits": 135,
    "queuedMs": 66,
    "executionMs": 2,
    "preset": "fast",
    "model": "kata1-tf2-b10c384-s2941M-d5872M",
    "gpuName": "NVIDIA L20"
  }
}
```

## About

## What it does

Go Position Analysis evaluates a single Go position with the KataGo engine. You send the moves played so far (plus any setup stones), the ruleset, komi and board size — anything from 2×2 to 19×19 — and get back ranked candidate moves, the expected line of play after each, Black's win probability and expected score lead, and optionally a point-by-point ownership map.

It has one endpoint, `Analyze Go Position`. Its `query.moves` and `query.rules` describe the game, `query.maxVisits` (16–1,000) trades speed for strength, and the `include…` flags add ownership maps, their uncertainty, raw policy probabilities and visit counts along each line. Win rates and scores are always from Black's side. Capacity is shared: 10 requests per minute and 10,000 per day across all buyers, with cold starts of up to 40 seconds.

Go Position Analysis is a good fit when you need engine-strength move suggestions or a position evaluation inside a Go app, a game-review tool, a teaching site or a bot — without running a GPU and KataGo yourself.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/chensichengmalu/service/analyze-go-position
