# Chess Time Control Classifier

> Chess Time Control Classifier is a paid API for AI agents from chess-notation.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Classifies a chess time control (bullet, blitz, rapid, or classical) from base minutes and optional increment, and returns estimated game length.

## Facts

- Endpoint: GET https://chess-notation.x402tookit.com/time-control?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chess-time-control-classifier-bee03c8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vfL4FICAPnklLGYqm2SkA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chess-time-control-classifier-bee03c8a
```

Example prompt: What time control category is a chess game with 5 minutes base time and 3 seconds increment per move — is it bullet, blitz, rapid, or classical, and how long would the game typically last?

## When to prefer this

Use this endpoint when you need to programmatically classify a chess time control into its standard category (bullet/blitz/rapid/classical) and get an estimated game duration from raw clock parameters. Prefer it over manual lookup tables when building chess apps, tournament managers, or game-analysis tools that need to label or filter games by time control type.

## Known failure modes

- Missing required baseMinutes parameter returns an error
- Non-numeric or negative baseMinutes value may cause a validation error
- Very large or unusual values may return degraded or uncategorized results
- Network or payment authorization failure prevents response

## How this service works

Classify a chess time control (bullet, blitz, rapid, classical) from base minutes and increment, with estimated length.

## Output

Returns the time control category (bullet, blitz, rapid, or classical), standard notation string, estimated seconds per player, estimated total game minutes for both players, maximum game minutes if all time is used, along with the echoed base minutes and increment seconds, plus optional summary, verdict, reasons, and source/disclaimer fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "baseMinutes"
     ],
     "properties": {
      "baseMinutes": {
       "type": "number",
       "description": "Starting time per player in minutes (for example 5 or 0.5)"
      },
      "incrementSeconds": {
       "type": "number",
       "description": "Seconds added per move (default 0)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "category": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "notation": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "baseMinutes": {
       "type": [
        "null",
        "number"
       ]
      },
      "incrementSeconds": {
       "type": [
        "null",
        "number"
       ]
      },
      "estimatedSecondsPerPlayer": {
       "type": [
        "null",
        "number"
       ]
      },
      "estimatedMinutesBothPlayers": {
       "type": [
        "null",
        "number"
       ]
      },
      "maxGameMinutesIfAllTimeUsed": {
       "type": [
        "null",
        "number"
       ]
      }
     }
    }
   }
  }
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chess-time-control-classifier-bee03c8a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chess-notation.x402tookit.com](https://www.zero.xyz/host/chess-notation.x402tookit.com/llms.txt)