{"uid":"cap_qrot8xrS55JF3KxLfLTQn","slug":"covid-gram-critical-illness-probability-calculator-liang-2020-13f48497","name":"COVID-GRAM Critical Illness Probability Calculator (Liang 2020)","description":"Liang 2020 COVID-GRAM logistic probability of critical illness (ICU, invasive ventilation, or death) among hospitalized COVID-19 from age, caller-assigned chest radiograph abnormality, hemoptysis, dyspnea, unconsciousness, comorbidity count, cancer history, neutrophil-to-lymphocyte ratio, LDH (U/L), and direct bilirubin (umol/L). Table 3 coefficients. magent does not read the film or count comorbidities. Not a diagnosis or ICU-allocation order.","url":"https://api.magentlab.com/api/calc/cgram","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":["age","chest_xray_abnormal","hemoptysis","dyspnea","unconsciousness","number_of_comorbidities","cancer_history","nlr","ldh_u_l","direct_bilirubin_umol_l"],"properties":{"age":{"type":"integer","description":"Age in years (integer 1-120). Liang 2020 Table 3: +0.0276 per year (OR 1.03 per year). Development cohort ages 1-95."},"nlr":{"type":"number","description":"Neutrophil-to-lymphocyte ratio (0.01-200). Liang 2020 Table 3: +0.0562 per unit (OR 1.06). Caller assigns the ratio; magent does not compute it from counts."},"dyspnea":{"type":"boolean","description":"Dyspnea (shortness of breath) as assigned by the caller (true or false). Liang 2020 Table 3: true adds 0.632 (OR 1.88)."},"ldh_u_l":{"type":"number","description":"Lactate dehydrogenase in U/L (1-5000). Liang 2020 Table 3: +0.0024 per U/L (OR 1.002). magent does not convert other LDH units."},"hemoptysis":{"type":"boolean","description":"Hemoptysis as assigned by the caller (true or false). Liang 2020 Table 3: true adds 1.5116 (OR 4.53)."},"cancer_history":{"type":"boolean","description":"Cancer history as assigned by the caller (true or false). Liang 2020 Table 3: true adds 1.4037 (OR 4.07), separate from the comorbidity count."},"unconsciousness":{"type":"boolean","description":"Unconsciousness as assigned by the caller (true or false). Liang 2020 Table 3: true adds 1.5494 (OR 4.71)."},"chest_xray_abnormal":{"type":"boolean","description":"Chest radiograph abnormality as assigned by the caller (true or false). Liang 2020 Table 3: true adds 1.2205 (OR 3.39). magent does not read the film."},"direct_bilirubin_umol_l":{"type":"number","description":"Direct bilirubin in umol/L (0-200). Liang 2020 Table 3: +0.1376 per umol/L (OR 1.15). magent does not convert mg/dL."},"number_of_comorbidities":{"type":"integer","description":"Caller-assigned count of comorbidities as Liang 2020 defined (integer 0-10): COPD, diabetes, hypertension, cardiovascular disease, cerebrovascular disease, hepatitis B, cancer, chronic kidney disease, immunodeficiency. Table 3: +0.4668 per comorbidity (OR 1.60). magent does not count diagnoses."}}}},"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_Geoo0k1Xfj2T16mm0S2aN","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 logistic probability of critical illness (ICU admission, invasive ventilation, or death) in hospitalized COVID-19 patients using the Liang 2020 COVID-GRAM model (Table 3 coefficients).","exampleAgentPrompt":"Using the Liang 2020 COVID-GRAM model, estimate the critical illness probability for a 67-year-old COVID-19 inpatient with an abnormal chest X-ray, dyspnea present, no hemoptysis, no unconsciousness, 2 comorbidities, no cancer history, a neutrophil-to-lymphocyte ratio of 8.5, LDH of 420 U/L, and direct bilirubin of 12 umol/L.","exampleUseCases":[{"title":"Rapid ICU risk triage at admission","prompt":"I need to quickly score a 72-year-old COVID-19 patient just admitted — chest X-ray is abnormal, she has dyspnea and no hemoptysis, is alert, has 3 comorbidities, no cancer history, NLR is 11.2, LDH is 510 U/L, and direct bilirubin is 18 umol/L. What's her COVID-GRAM critical illness probability?"},{"title":"Monitoring high-risk patient progression","prompt":"My 58-year-old COVID-19 patient's labs changed overnight — NLR went from 6 to 14, LDH is now 380 U/L, direct bilirubin 9 umol/L. He has dyspnea, abnormal CXR, no hemoptysis or unconsciousness, 1 comorbidity, no cancer history. Recalculate his Liang 2020 COVID-GRAM score."},{"title":"Clinical research cohort risk scoring","prompt":"For a study dataset, score a 45-year-old COVID-19 patient with no chest X-ray abnormality, no hemoptysis, no dyspnea, fully conscious, 0 comorbidities, no cancer history, NLR of 3.1, LDH of 210 U/L, and direct bilirubin of 5 umol/L using the COVID-GRAM logistic model."}],"resultDescription":"Returns the COVID-GRAM logistic probability (0–1) of critical illness (ICU admission, invasive mechanical ventilation, or death) for a hospitalized COVID-19 patient, derived from Liang 2020 Table 3 coefficients applied to the supplied clinical inputs.","failureModes":["Missing required query parameter (e.g. age, nlr, ldh_u_l) returns a 400 error","Age out of range (< 1 or > 120) or NLR out of range (< 0.01 or > 200) may return a validation error","LDH or bilirubin values in non-supported units (e.g. µkat/L instead of U/L) will produce incorrect scores without warning — caller must convert","Payment not provided or insufficient USDC results in 402 Payment Required","Boolean flags must be true/false; any other value may cause a parse error"],"whenToPreferThis":"Use this endpoint when you need the validated Liang 2020 COVID-GRAM logistic score specifically, with exact Table 3 coefficients, for hospitalized COVID-19 patients. Prefer it when you already have structured clinical values (NLR, LDH, bilirubin, symptom flags) and want a reproducible, published-model probability rather than a custom heuristic. It is not a replacement for clinical judgment, chest film reading, or comorbidity counting — the caller must supply those assessments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:46:40.781Z","isFirstParty":false}