{"uid":"cap_5p-pMdJRrMT04m_QrVViV","slug":"ball-score-calculator-soumerai-2019-for-relapsed-refractory-cll-7511228d","name":"BALL Score Calculator (Soumerai 2019) for Relapsed/Refractory CLL","description":"Soumerai 2019 BALL score for relapsed or refractory CLL. Four caller-assigned 1-point flags (max 4): beta-2-microglobulin at the paper's published cutoff (>=5 mg/dL), LDH > laboratory ULN, anemia (Hb <110 g/L women or <120 g/L men), and time from initiation of last therapy <24 months. Risk low 0-1, intermediate 2-3, high 4. magent does not assay labs or convert B2M mg/L vs mg/dL. Not a treatment recommendation.","url":"https://api.magentlab.com/api/calc/ball","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":["b2m_ge_5","ldh_gt_uln","anemia","last_therapy_lt_24mo"],"properties":{"anemia":{"type":"boolean","description":"Anemia as assigned by the caller using Soumerai 2019 hemoglobin cutoffs (hemoglobin <110 g/L in women or <120 g/L in men). true or false. magent does not take a hemoglobin number or sex and does not assay hemoglobin."},"b2m_ge_5":{"type":"boolean","description":"Serum β2-microglobulin at or above the Soumerai 2019 published cutoff (≥5 mg/dL) as assigned by the caller. true or false. magent does not assay B2M and does not convert mg/L versus mg/dL."},"ldh_gt_uln":{"type":"boolean","description":"Serum LDH above the laboratory upper limit of normal as assigned by the caller (Soumerai 2019). true or false. magent does not assay LDH."},"last_therapy_lt_24mo":{"type":"boolean","description":"Time from initiation of last therapy <24 months as assigned by the caller (Soumerai 2019). true or false. magent does not read a treatment calendar."}}}},"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_ileoKWM4Uq96rS9AYJ6PF","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":"Computes the Soumerai 2019 BALL prognostic score (0–4) for relapsed or refractory CLL and returns a risk category (low, intermediate, or high) based on four caller-assigned boolean flags.","exampleAgentPrompt":"Calculate the Soumerai 2019 BALL score for my relapsed CLL patient: beta-2-microglobulin is ≥5 mg/dL (true), LDH is above the lab ULN (true), no anemia (false), and last therapy was started more than 24 months ago (false).","exampleUseCases":[{"title":"Pre-clinic CLL risk triage","prompt":"I have a relapsed CLL patient whose B2M is ≥5 mg/dL, LDH is above the ULN, hemoglobin is fine so no anemia, and they finished their last line of therapy 30 months ago. Can you run the Soumerai BALL score to see whether they're low, intermediate, or high risk?"},{"title":"Oncology app automated scoring","prompt":"For our CLL dashboard, calculate the BALL score for a patient with b2m_ge_5=true, ldh_gt_uln=false, anemia=true, and last_therapy_lt_24mo=true — I need the numeric score and risk tier."},{"title":"Clinical research eligibility check","prompt":"We're screening relapsed/refractory CLL patients for a high-risk cohort. This patient has elevated B2M (≥5 mg/dL), normal LDH, is anemic per Soumerai hemoglobin cutoffs, and had their last therapy initiated 18 months ago. What's their BALL score and risk group?"}],"resultDescription":"Returns a numeric BALL score (integer 0–4) and a risk category string — low (0–1), intermediate (2–3), or high (4) — based on the sum of the four boolean input flags. Does not provide treatment recommendations or lab assay results.","failureModes":["Missing required boolean query parameter returns a 400/validation error","Passing numeric values instead of boolean true/false may be rejected","Incorrect unit conversion (mg/L vs mg/dL for B2M) not caught by the API — caller must resolve units before flagging","Network or payment authentication failure returns 402 or 5xx"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic computation of the Soumerai 2019 BALL score for a relapsed or refractory CLL patient and have already pre-evaluated the four lab/clinical criteria as booleans. Prefer this over manual calculation when automating oncology workflows or building clinical decision-support pipelines. Not appropriate if you need raw lab values interpreted or units converted (B2M mg/L vs mg/dL must be resolved by the caller).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:06:22.053Z","isFirstParty":false}