# Golf Handicap Calculator (World Handicap System)

> Golf Handicap Calculator (World Handicap System) is a paid API for AI agents from sports-calc.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Calculates a World Handicap System (WHS) index from up to 20 rounds and optionally computes a course handicap for a target course.

## Facts

- Endpoint: GET https://sports-calc.x402tookit.com/golf-handicap?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/golf-handicap-calculator-world-handicap-system-ed7eb87c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_empibXovGuheikqxZ3W75

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 golf-handicap-calculator-world-handicap-system-ed7eb87c
```

Example prompt: Can you work out my WHS handicap index from my last 8 rounds where I shot 88, 91, 85, 93, 87, 90, 84, 89 on a course with a rating of 71.4 and slope of 128, and also tell me my course handicap if I'm playing a course with rating 72.1, slope 132, and par 72?

## When to prefer this

Use this endpoint when you need an official World Handicap System handicap index computation from raw scores or pre-computed differentials, especially when you also need to convert that index to a course-specific playing handicap. Prefer this over manual calculation or generic sports APIs when WHS-compliant logic (best differential selection, adjustments, rounding) is required.

## Known failure modes

- Missing required scores or differentials — returns error if neither scores nor differentials are provided
- Insufficient rounds — fewer than 3 scores/differentials may not produce a valid index
- Invalid slope rating outside 55–155 range — rejected or produces unexpected results
- Missing courseRating when scores are provided — differentials cannot be computed without it
- Mismatched parameter combinations — providing differentials alongside courseRating/slopeRating may be ignored or cause confusion

## How this service works

World Handicap System index from your last 3 to 20 rounds (best differentials), plus course handicap for a course.

## Output

Returns the calculated WHS handicap index (rounded), course handicap (rounded and unrounded), the list of differentials computed from input scores, the lowest differentials used in the calculation, the number of scores used, any adjustments applied, a summary explanation, and optional reasons or warnings about the calculation.

## 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": [],
     "properties": {
      "scores": {
       "type": "string",
       "description": "Adjusted gross scores, comma separated (use with courseRating and slopeRating)"
      },
      "targetPar": {
       "type": "number",
       "description": "Par to play"
      },
      "slopeRating": {
       "type": "number",
       "description": "Slope rating of the rounds, 55 to 155 (with scores)"
      },
      "targetSlope": {
       "type": "number",
       "description": "Slope to play"
      },
      "courseRating": {
       "type": "number",
       "description": "Course rating of the rounds (with scores)"
      },
      "differentials": {
       "type": "string",
       "description": "Score differentials, comma separated (instead of scores)"
      },
      "targetCourseRating": {
       "type": "number",
       "description": "Course rating to play, for course handicap"
      }
     }
    }
   },
   "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"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "adjustment": {
       "type": [
        "null",
        "number"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "lowestUsed": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "number"
       }
      },
      "notChecked": {
       "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/golf-handicap-calculator-world-handicap-system-ed7eb87c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sports-calc.x402tookit.com](https://www.zero.xyz/host/sports-calc.x402tookit.com/llms.txt)