Infection / VTE · LIVE
Khorana score
Compute the Khorana 2008 Blood predictive model for chemotherapy-associated thrombosis from caller-assigned cancer site, pre-chemotherapy labs, ESA use, and BMI ≥35.
Markdown: /docs/khorana.md · Canonical: https://magentlab.com/docs/khorana
Not a medical device. Not a diagnosis, dose, or listing recommendation.
What it computes
Compute the Khorana 2008 Blood predictive model for chemotherapy-associated thrombosis from caller-assigned cancer site, pre-chemotherapy labs, ESA use, and BMI ≥35.
When to use
When an agent needs the published Khorana 2008 score (not Padua, Caprini, or a VTE diagnosis) for a patient starting chemotherapy as in the paper.
When not to use
- Not a diagnosis of VTE. magent does not diagnose venous thromboembolism.
- Not Padua or Caprini. This tool is the Khorana 2008 Blood predictive model only.
- magent does not assign cancer site from histology text. Caller must send very_high, high, or other.
- BMI ≥35 is a caller-applied flag; magent does not take height or weight.
- Hemoglobin <10 g/dL or ESA scores 1 once, not twice. Platelets 350 ×10^9/L scores. WBC 11.0 ×10^9/L does not score; >11 does. Score 0 is low, 1–2 intermediate, ≥3 high.
Formula
Khorana = cancer_site (very_high 2, high 1, other 0) + (platelets>=350) + (hemoglobin<10 g/dL or ESA) + (wbc>11 x10^9/L) + (BMI>=35); max 6; 0 low, 1-2 intermediate, >=3 high
Citation
- Authors
- Khorana AA, Kuderer NM, Culakova E, Lyman GH, Francis CW
- Source
- Blood. 2008;111(10):4902-4907
Worked example
Other site, labs not scoring
Given:
bmi_ge_35=falsecancer_site=othererythropoiesis_stimulating_agent=falsehemoglobin_g_dl=12platelets_10e9_l=200wbc_k_ul=8
- cancer_site other → 0; platelets 200 < 350 → 0; hemoglobin 12 g/dL without ESA → 0; WBC 8 k/µL → 0; BMI flag false → 0
- Score = 0 (max 6); khorana_risk low
Very high site plus platelets 350 is high
Given:
bmi_ge_35=falsecancer_site=very_higherythropoiesis_stimulating_agent=falsehemoglobin_g_dl=12platelets_10e9_l=350wbc_k_ul=8
- cancer_site very_high → 2; platelets 350 ≥ 350 → 1
- Score = 3 (max 6); khorana_risk high
Also searched as
- Khorana score
- Khorana risk score
- chemotherapy-associated thrombosis
- Khorana VTE score
- cancer thrombosis score
- Khorana 2008
Try
Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.
Full URL: https://api.magentlab.com/api/calc/khorana?cancer_site=other&platelets_10e9_l=200&hemoglobin_g_dl=12&erythropoiesis_stimulating_agent=false&wbc_k_ul=8&bmi_ge_35=false
Call
Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params
return HTTP 400 before any quote or charge.
curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/khorana?cancer_site=other&platelets_10e9_l=200&hemoglobin_g_dl=12&erythropoiesis_stimulating_agent=false&wbc_k_ul=8&bmi_ge_35=false"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
cancer_site |
string | required | Caller-assigned Khorana site class. very_high (stomach or pancreas) scores 2; high (lung, lymphoma, gynecologic, bladder, or testicular) scores 1; other scores 0. magent does not assign cancer site from histology text. |
platelets_10e9_l |
number | required | Pre-chemotherapy platelet count ×10^9/L (1-2000). ≥350 scores 1 (350 scores; 349 does not). |
hemoglobin_g_dl |
number | optional | Hemoglobin in g/dL (3-22). Provide this or hemoglobin_g_l, not both. <10 scores 1 with ESA (once, not twice). 10.0 does not score unless ESA is true. |
hemoglobin_g_l |
number | optional | Hemoglobin in g/L (30-220). Converted as hemoglobin_g_dl = hemoglobin_g_l / 10. Provide this or hemoglobin_g_dl, not both. |
erythropoiesis_stimulating_agent |
boolean | required | Use of an erythropoiesis-stimulating agent as assigned by the caller. true or false. Scores 1 with hemoglobin <10 g/dL (once, not twice). |
wbc_k_ul |
number | optional | WBC in 10^3/µL (same as 10^9/L). Provide wbc_k_ul or wbc_ul. Range 0.01-500. >11 scores 1 (11.0 does not). |
wbc_ul |
number | optional | WBC in cells/µL (same as cells/mm^3). Provide wbc_k_ul or wbc_ul. Range 10-500000. >11000 scores 1 (11000 does not). |
bmi_ge_35 |
boolean | required | BMI ≥35 as assigned by the caller. true or false. magent does not take height or weight. 1 point if true. |
Bulk (POST)
POST the same path with a JSON items array. Price is n times the GET unit. Invalid items return HTTP 400 before settlement.
- 1 to 25 items. Each item uses the same keys as the GET query parameters.
- The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
- HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
- Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
- x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.
Example request (fixture)
{
"items": [
{
"bmi_ge_35": "false",
"cancer_site": "other",
"erythropoiesis_stimulating_agent": "false",
"hemoglobin_g_dl": "12",
"platelets_10e9_l": "200",
"wbc_k_ul": "8"
},
{
"bmi_ge_35": "false",
"cancer_site": "other",
"erythropoiesis_stimulating_agent": "false",
"hemoglobin_g_dl": "12",
"platelets_10e9_l": "200",
"wbc_k_ul": "8"
}
]
}
Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.
Example 200 (fixture)
{
"count": 2,
"path": "/api/calc/khorana",
"items": [
{
"components": [
{
"value": "other",
"factor": "cancer_site",
"points": 0,
"present": false
},
{
"value": 200.0,
"factor": "platelets",
"points": 0,
"present": false
},
{
"value": {
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0
},
"factor": "hemoglobin_or_esa",
"points": 0,
"present": false
},
{
"value": 8.0e3,
"factor": "wbc",
"points": 0,
"present": false
},
{
"factor": "bmi_ge_35",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Khorana AA, Kuderer NM, Culakova E, Lyman GH, Francis CW",
"doi": "10.1182/blood-2007-10-116327",
"id": "khorana-2008",
"source": "Blood. 2008;111(10):4902-4907",
"title": "Development and validation of a predictive model for chemotherapy-associated thrombosis"
},
"formula": "khorana",
"formula_expression": "Khorana = cancer_site (very_high 2, high 1, other 0) + (platelets>=350) + (hemoglobin<10 g/dL or ESA) + (wbc>11 x10^9/L) + (BMI>=35); max 6; 0 low, 1-2 intermediate, >=3 high",
"max_score": 6,
"score": 0,
"platelets_10e9_l": 200.0,
"wbc_ul": 8.0e3,
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0,
"bmi_ge_35": false,
"cancer_site": "other",
"khorana_risk": "low"
},
{
"components": [
{
"value": "other",
"factor": "cancer_site",
"points": 0,
"present": false
},
{
"value": 200.0,
"factor": "platelets",
"points": 0,
"present": false
},
{
"value": {
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0
},
"factor": "hemoglobin_or_esa",
"points": 0,
"present": false
},
{
"value": 8.0e3,
"factor": "wbc",
"points": 0,
"present": false
},
{
"factor": "bmi_ge_35",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Khorana AA, Kuderer NM, Culakova E, Lyman GH, Francis CW",
"doi": "10.1182/blood-2007-10-116327",
"id": "khorana-2008",
"source": "Blood. 2008;111(10):4902-4907",
"title": "Development and validation of a predictive model for chemotherapy-associated thrombosis"
},
"formula": "khorana",
"formula_expression": "Khorana = cancer_site (very_high 2, high 1, other 0) + (platelets>=350) + (hemoglobin<10 g/dL or ESA) + (wbc>11 x10^9/L) + (BMI>=35); max 6; 0 low, 1-2 intermediate, >=3 high",
"max_score": 6,
"score": 0,
"platelets_10e9_l": 200.0,
"wbc_ul": 8.0e3,
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0,
"bmi_ge_35": false,
"cancer_site": "other",
"khorana_risk": "low"
}
]
}
Response
| Field | Type | Description |
|---|---|---|
formula |
string | khorana |
formula_expression |
string | Exact expression used |
score |
integer | Total points 0-6 |
max_score |
integer | Always 6 |
khorana_risk |
string | low when score is 0; intermediate when 1-2; high when ≥3. Not a diagnosis. |
cancer_site |
string | Caller-assigned site class used: very_high, high, or other |
platelets_10e9_l |
number | Platelet count used (×10^9/L) |
hemoglobin_g_dl |
number | Hemoglobin used in g/dL (g/L inputs converted as g/dL = g/L / 10) |
erythropoiesis_stimulating_agent |
boolean | ESA flag used |
wbc_ul |
number | WBC used in cells/µL (wbc_k_ul converted as ×1000) |
bmi_ge_35 |
boolean | Caller-assigned BMI ≥35 flag used |
components |
array | Per-item points |
citation |
object | Khorana 2008 Blood citation |
disclaimer |
string | Not-a-device notice |
Example JSON
Machine form of the same example. Frozen fixture. Not a live lookup.
{
"components": [
{
"value": "other",
"factor": "cancer_site",
"points": 0,
"present": false
},
{
"value": 200.0,
"factor": "platelets",
"points": 0,
"present": false
},
{
"value": {
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0
},
"factor": "hemoglobin_or_esa",
"points": 0,
"present": false
},
{
"value": 8.0e3,
"factor": "wbc",
"points": 0,
"present": false
},
{
"factor": "bmi_ge_35",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Khorana AA, Kuderer NM, Culakova E, Lyman GH, Francis CW",
"doi": "10.1182/blood-2007-10-116327",
"id": "khorana-2008",
"source": "Blood. 2008;111(10):4902-4907",
"title": "Development and validation of a predictive model for chemotherapy-associated thrombosis"
},
"formula": "khorana",
"formula_expression": "Khorana = cancer_site (very_high 2, high 1, other 0) + (platelets>=350) + (hemoglobin<10 g/dL or ESA) + (wbc>11 x10^9/L) + (BMI>=35); max 6; 0 low, 1-2 intermediate, >=3 high",
"max_score": 6,
"score": 0,
"platelets_10e9_l": 200.0,
"wbc_ul": 8.0e3,
"erythropoiesis_stimulating_agent": false,
"hemoglobin_g_dl": 12.0,
"bmi_ge_35": false,
"cancer_site": "other",
"khorana_risk": "low"
}
Client errors (HTTP 400)
Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_cancer_site |
cancer_site must be very_high, high, or other. Returned before settlement; you are not charged. |
| 400 | invalid_platelets |
platelets_10e9_l must be a number from 1 to 2000 Returned before settlement; you are not charged. |
| 400 | invalid_hemoglobin |
hemoglobin_g_l (30-220) or hemoglobin_g_dl (3-22) is required, not both. Returned before settlement; you are not charged. |
| 400 | invalid_wbc |
wbc_k_ul (0.01-500) or wbc_ul (10-500000) is required Returned before settlement; you are not charged. |
| 400 | invalid_flag |
boolean clinical flags must be true or false Returned before settlement; you are not charged. |
| 400 | invalid_items |
POST body must be a JSON object with only an items array Returned before settlement; you are not charged. |
| 400 | invalid_item_count |
items must be an array of 1 to 25 objects Returned before settlement; you are not charged. |
| 400 | invalid_item |
each items entry must be a JSON object Returned before settlement; you are not charged. |
Related tools
- Padua score — Compute the Barbar 2010 Padua Prediction Score for VTE risk in hospitalized medical patients from age and ten caller-assigned findings.
- Wells DVT — Compute the Wells deep-vein thrombosis probability score and return three-tier and two-tier bands.
Payment
Required query parameters must be present and valid. Invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64
PAYMENT-REQUIRED
header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake
and shared payment errors: Payments.
Stdio MCP: /docs/mcp.
Guarantees
- Invalid query parameters return HTTP 400 before settlement. You are not charged.
- Settlement finishes before the tool executes (paymentFlow upfront). Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
- HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
- Execution is timeout-bounded and concurrency-capped.
- Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.