# Hevesi 2018 Hip RAPID Score Calculator

> Hevesi 2018 Hip RAPID Score Calculator is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Computes the Hevesi 2018 hip RAPID score (0–5) from sex, Tonnis grade, and cam morphology to stratify risk of high-grade acetabular labral and articular damage

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/rapid_hip
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hevesi-2018-hip-rapid-score-calculator-dd387fd9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P5-pR0rt5iH6iVYnbpM-c

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 hevesi-2018-hip-rapid-score-calculator-dd387fd9
```

Example prompt: Calculate the Hevesi 2018 hip RAPID score for a male patient with a Tonnis grade 1 and cam morphology present — what risk band does that put him in?

## When to prefer this

Use this endpoint when you need to arithmetically apply the Hevesi 2018 hip RAPID scoring system to discrete, caller-assigned clinical variables (sex, Tonnis grade 0–2, cam morphology). It is not a diagnostic tool, does not interpret imaging, and should not be used for Rahman 2014 pleural RAPID or any other RAPID variant. Prefer this over manual calculation when building clinical workflow agents, pre-operative risk summaries, or decision support pipelines that already have Tonnis grade and cam morphology assessed by a clinician or radiologist.

## Known failure modes

- Tonnis grade 3 supplied — invalid input, no grade 3 in derivation cohort, returns error
- Missing required parameter (sex, tonnis_grade, or cam_morphology) — 400 bad request
- tonnis_grade out of range (negative or >2) — validation error
- Payment not provided or insufficient — 402 Payment Required
- Incorrect type for cam_morphology (non-boolean) — schema validation error

## How this service works

Hevesi 2018 hip RAPID: sex (female 0, male 1) + Tonnis 0/1/2 (0, 2, 3 points; grade 3 invalid) + caller-assigned cam (1 if present). Max 5. Bands 0-1 low, 2-3 intermediate, 4-5 high. High-grade (ALAD 3-4) damage percent only at score 0 (10.5) and 5 (88.0). Not Rahman 2014 pleural RAPID. Not a diagnosis or operative plan. magent does not read radiographs or measure alpha angle.

## Output

Returns the computed RAPID score (integer 0–5), the corresponding risk band (low 0–1, intermediate 2–3, high 4–5), and — where applicable at scores 0 and 5 — the published percent probability of high-grade (ALAD grade 3–4) acetabular labral and articular damage from the Hevesi 2018 derivation cohort.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "sex",
      "tonnis_grade",
      "cam_morphology"
     ],
     "properties": {
      "sex": {
       "enum": [
        "female",
        "male"
       ],
       "type": "string",
       "description": "female or male (Hevesi 2018 Table 3). Male scores 1; female scores 0."
      },
      "tonnis_grade": {
       "type": "integer",
       "description": "Caller-assigned Tonnis osteoarthritis grade 0, 1, or 2 (Hevesi 2018 Table 3). Grade 0 scores 0; grade 1 scores 2; grade 2 scores 3. Grade 3 is invalid (the derivation had no grade 3). magent does not read radiographs."
      },
      "cam_morphology": {
       "type": "boolean",
       "description": "Caller-assigned cam morphology. true scores 1; false scores 0. Paper univariate used alpha angle >55°; magent does not measure alpha angle. true or false."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hevesi-2018-hip-rapid-score-calculator-dd387fd9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)