{"uid":"cap_fkBkn7J9DlclA9vX1oE2F","slug":"reach-b-hcc-risk-score-calculator-yang-2011-4bebfe3b","name":"REACH-B HCC Risk Score Calculator (Yang 2011)","description":"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.","url":"https://api.magentlab.com/api/calc/reach_b","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rz4T-tjmm-L-uHi5h01gk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Hepatology clinic HCC risk stratification","prompt":"I have a 55-year-old female chronic HBV patient, no cirrhosis, ALT is 30 U/L, HBeAg negative, HBV DNA 85,000 copies/mL — can you compute her REACH-B score and tell me her 5- and 10-year HCC risk?"},{"title":"Research cohort HCC risk scoring","prompt":"For a research dataset entry: male, age 62, ALT 18 U/L, HBeAg negative, HBV DNA 500 copies/mL — what is his Yang 2011 REACH-B score and the published 3-year HCC probability?"},{"title":"Patient counseling HCC risk estimate","prompt":"My hepatitis B patient is a 38-year-old male, ALT 60 U/L, HBeAg positive, HBV DNA 1,200,000 copies/mL, no cirrhosis — run the REACH-B calculator so I can discuss his 10-year liver cancer risk with him."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:52:30.247Z","isFirstParty":false}