# REACH-B HCC Risk Score Calculator (Yang 2011)

> REACH-B HCC Risk Score Calculator (Yang 2011) 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-13).

Calculates the Yang 2011 REACH-B 17-point hepatocellular carcinoma (HCC) risk score for non-cirrhotic chronic hepatitis B patients and returns published 3-, 5-, and 10-year HCC incidence probabilities.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/reach_b
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reach-b-hcc-risk-score-calculator-yang-2011-4bebfe3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fkBkn7J9DlclA9vX1oE2F

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 reach-b-hcc-risk-score-calculator-yang-2011-4bebfe3b
```

Example prompt: Calculate the REACH-B HCC risk score for a 47-year-old male chronic hepatitis B patient with an ALT of 52 U/L, HBeAg positive, and HBV DNA of 250,000 copies/mL — and give me the published 3-, 5-, and 10-year HCC risk percentages.

## When to prefer this

Use this endpoint when you need to compute the validated Yang 2011 REACH-B score specifically for non-cirrhotic chronic hepatitis B patients aged 30–65 and want the published 3/5/10-year HCC risk percentages. Prefer this over generic risk tools when the patient profile matches the REVEAL-HBV derivation cohort and you have caller-supplied ALT and HBV DNA in copies/mL (not IU/mL). Do not use for cirrhotic patients, patients outside the 30–65 age range, or when you need a biopsy-based fibrosis assessment.

## Known failure modes

- Age outside 30–65 is rejected — the model does not score ages below 30 or above 65
- Invalid or out-of-range ALT (must be 1–10,000 U/L) returns an error
- HBV DNA outside 0–10,000,000,000 copies/mL returns an error
- Invalid sex enum value (not 'male' or 'female') returns a validation error
- Missing required query parameters return a 400-level error
- Payment failure (x402) if USDC funds are insufficient

## How this service works

Yang 2011 REACH-B 17-point HCC risk (non-cirrhotic REVEAL-HBV). Sex female 0, male 2; age 30-65 (30-34 0 through 60-65 6); ALT U/L <15 0, 15-44 1, >=45 2; HBeAg positive 2; HBV DNA copies/mL <10000 0, 10000-99999 3, 100000-999999 5, >=1000000 4. Returns score 0-17 and published 3/5/10-year percents. Not a diagnosis, not a biopsy, not for cirrhosis. magent does not assay ALT or HBV DNA.

## Output

Returns the computed REACH-B integer score (0–17) derived from the five weighted Yang 2011 inputs, along with the published 3-year, 5-year, and 10-year HCC incidence percentages corresponding to that score. Does not provide a diagnosis and is not applicable to patients with cirrhosis.

## 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",
      "age",
      "alt_u_l",
      "hbeag_positive",
      "hbv_dna_copies_per_ml"
     ],
     "properties": {
      "age": {
       "type": "integer",
       "description": "Age in years. Yang 2011 derivation 30-65 only: 30-34 scores 0; 35-39 scores 1; 40-44 scores 2; 45-49 scores 3; 50-54 scores 4; 55-59 scores 5; 60-65 scores 6. Age 34 scores 0; 35 scores 1; 65 scores 6. Age outside 30-65 is rejected. This tool does not score age >=65 as 7."
      },
      "sex": {
       "enum": [
        "female",
        "male"
       ],
       "type": "string",
       "description": "female or male. Yang 2011: female scores 0; male scores 2."
      },
      "alt_u_l": {
       "type": "number",
       "description": "Alanine aminotransferase in U/L (1-10000). Caller-assigned; magent does not assay ALT. Yang 2011: <15 scores 0; 15-44 scores 1; >=45 scores 2. ALT 14 scores 0; 15 and 44 score 1; 45 scores 2."
      },
      "hbeag_positive": {
       "type": "boolean",
       "description": "HBeAg positive as assigned by the caller (Yang 2011). true scores 2; false scores 0. magent does not assay HBeAg."
      },
      "hbv_dna_copies_per_ml": {
       "type": "integer",
       "description": "HBV DNA in copies/mL (integer 0-10000000000). Yang 2011 uses copies/mL, not IU/mL. magent does not assay HBV DNA and does not convert units. <300 scores 0; 300-9999 scores 0; 10000-99999 scores 3; 100000-999999 scores 5; >=1000000 scores 4 (non-monotonic: 10^6 scores 4, 10^5 to 10^6-1 scores 5)."
      }
     }
    }
   },
   "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/reach-b-hcc-risk-score-calculator-yang-2011-4bebfe3b/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)