MAGENT

Body size · LIVE

CAROC 2010 10-year MOF category

CAROC 2010

Apply the CAROC 2010 10-year major osteoporotic fracture category from caller-assigned age, sex, femoral-neck T-score, and yes/no fragility and glucocorticoid flags. Returns basal_risk_level from the printed T-score table and risk_level after Papaioannou 2010 clinical bumps.

LIVE $0.005 USDC GET /api/calc/caroc

Markdown: /docs/caroc.md · Canonical: https://magentlab.com/docs/caroc

Not a medical device. Not a diagnosis, dose, or listing recommendation.

What it computes

Apply the CAROC 2010 10-year major osteoporotic fracture category from caller-assigned age, sex, femoral-neck T-score, and yes/no fragility and glucocorticoid flags. Returns basal_risk_level from the printed T-score table and risk_level after Papaioannou 2010 clinical bumps.

When to use

When an agent already has age, sex, a femoral-neck T-score, and the published clinical flags and needs the CAROC 2010 low, moderate, or high class. magent does not perform DXA, take a fracture history, or compute a steroid dose. Not FRAX.

When not to use

  • Not a medical device and not a diagnosis or treatment order.
  • Not FRAX and not a bisphosphonate order.
  • femoral_neck_t_score is caller-assigned. magent does not perform DXA. The NHANES III Caucasian-women reference is a densitometry convention for how that T-score was computed; this tool does not take a race input.
  • Age 50-89 only. Ages 50-85 map to the printed 5-year row; 86-89 use the 85-year row.
  • Prolonged glucocorticoids means at least 3 months in the prior year at prednisone-equivalent 7.5 mg/day or more, as assigned by the caller. magent does not compute a steroid dose.
  • Hip or spine fragility, or multiple fragility fractures, is high regardless of BMD. Fracture after 40 plus prolonged glucocorticoids is high. Either of those two flags alone bumps one class.
  • ten_year_mof_label is the published CAROC 2010 category label (low <10%, moderate 10-20%, high >20%), not an individualized percent.

Formula

CAROC 2010 10-year MOF category from age, sex, and caller-assigned femoral-neck T-score, then clinical bumps. row_age = min(85, max(50, 5 * floor(age / 5))) for age 50-89. Basal low if T-score is strictly above the printed moderate floor; high if strictly below the moderate ceiling; moderate inclusive between. Women 50/55: low > -2.5, moderate -2.5 to -3.8, high < -3.8; 60: > -2.3 / -2.3 to -3.7 / < -3.7; 65: > -1.9 / -1.9 to -3.5 / < -3.5; 70: > -1.7 / -1.7 to -3.2 / < -3.2; 75: > -1.2 / -1.2 to -2.9 / < -2.9; 80: > -0.5 / -0.5 to -2.6 / < -2.6; 85: > +0.1 / +0.1 to -2.2 / < -2.2. Men 50/55: low > -2.5, moderate -2.5 to -3.9, high < -3.9; 60: > -2.5 / -2.5 to -3.7 / < -3.7; 65: > -2.4 / -2.4 to -3.7 / < -3.7; 70: > -2.3 / -2.3 to -3.7 / < -3.7; 75: > -2.3 / -2.3 to -3.8 / < -3.8; 80: > -2.1 / -2.1 to -3.8 / < -3.8; 85: > -2.0 / -2.0 to -3.8 / < -3.8. hip_or_spine_fragility or multiple_fragility_fractures → high; else fragility_fracture_after_40 and prolonged_glucocorticoids → high; else either of those two flags bumps one class (low→moderate, moderate→high). Labels: low <10%, moderate 10-20%, high >20% 10-year MOF. Papaioannou 2010 / Lentle table. Not FRAX.

Citation

Title
2010 clinical practice guidelines for the diagnosis and management of osteoporosis in Canada: summary
Authors
Papaioannou A, Morin S, Cheung AM, Atkinson S, Brown JP, Feldman S, et al.
Source
CMAJ. 2010;182(17):1864-1873
DOI
10.1503/cmaj.100771

Worked example

Age 50 woman, T-score -1.0, no flags (low)

Given: age=50femoral_neck_t_score=-1.0fragility_fracture_after_40=falsehip_or_spine_fragility=falsemultiple_fragility_fractures=falseprolonged_glucocorticoids=falsesex=female

  1. age 50 maps to row_age 50
  2. female row 50: T-score -1.0 is > -2.5 → basal_risk_level low
  3. no clinical flags → risk_level low
  4. ten_year_mof_label is <10%

Age 50 woman, T-score -3.0, no flags (moderate)

Given: age=50femoral_neck_t_score=-3.0fragility_fracture_after_40=falsehip_or_spine_fragility=falsemultiple_fragility_fractures=falseprolonged_glucocorticoids=falsesex=female

  1. female row 50: T-score -3.0 is in -2.5 to -3.8 inclusive → basal_risk_level moderate
  2. no clinical flags → risk_level moderate
  3. ten_year_mof_label is 10-20%

Age 50 woman, T-score -4.0, no flags (high)

Given: age=50femoral_neck_t_score=-4.0fragility_fracture_after_40=falsehip_or_spine_fragility=falsemultiple_fragility_fractures=falseprolonged_glucocorticoids=falsesex=female

  1. female row 50: T-score -4.0 is < -3.8 → basal_risk_level high
  2. no clinical flags → risk_level high
  3. ten_year_mof_label is >20%

Age 50 woman, T-score -1.0, fragility fracture after 40 (bump to moderate)

Given: age=50femoral_neck_t_score=-1.0fragility_fracture_after_40=truehip_or_spine_fragility=falsemultiple_fragility_fractures=falseprolonged_glucocorticoids=falsesex=female

  1. basal_risk_level is low (T-score -1.0 > -2.5)
  2. fragility_fracture_after_40 alone bumps one class → risk_level moderate

Age 50 woman, T-score -1.0, hip or spine fragility (high)

Given: age=50femoral_neck_t_score=-1.0fragility_fracture_after_40=falsehip_or_spine_fragility=truemultiple_fragility_fractures=falseprolonged_glucocorticoids=falsesex=female

  1. basal_risk_level is low
  2. hip_or_spine_fragility is high regardless of BMD → risk_level high

Also searched as

  • CAROC 2010
  • CAROC femoral-neck T-score
  • 10-year MOF category
  • Papaioannou 2010 CAROC
  • Lentle CAROC table
  • major osteoporotic fracture category
  • CAROC low moderate high
  • femoral neck T-score bands

Try

Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.

/api/calc/caroc?age=50&sex=female&femoral_neck_t_score=-1.0&fragility_fracture_after_40=false&prolonged_glucocorticoids=false&hip_or_spine_fragility=false&multiple_fragility_fractures=false

Full URL: https://api.magentlab.com/api/calc/caroc?age=50&sex=female&femoral_neck_t_score=-1.0&fragility_fracture_after_40=false&prolonged_glucocorticoids=false&hip_or_spine_fragility=false&multiple_fragility_fractures=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/caroc?age=50&sex=female&femoral_neck_t_score=-1.0&fragility_fracture_after_40=false&prolonged_glucocorticoids=false&hip_or_spine_fragility=false&multiple_fragility_fractures=false"

Parameters

Name Type Required Description
age integer required Age in years. CAROC 2010 accepts 50-89 (integer). Ages 50-85 map to the printed 5-year row; 86-89 use the 85-year row. Ages under 50 or over 89 are rejected. magent does not take a date of birth.
sex string required Sex used by the printed table: female or male.
femoral_neck_t_score number required Caller-assigned femoral-neck BMD T-score (-6.0 to 4.0). The NHANES III Caucasian-women reference is a densitometry convention for how that T-score was computed; this tool does not take a race input. magent does not perform DXA.
fragility_fracture_after_40 boolean required Fragility fracture after age 40 as assigned by the caller (Papaioannou 2010). true or false. Alone, bumps one class; with prolonged_glucocorticoids, risk_level is high. magent does not take a fracture history.
prolonged_glucocorticoids boolean required Prolonged glucocorticoids as assigned by the caller: at least 3 months in the prior year at prednisone-equivalent 7.5 mg/day or more (Papaioannou 2010). true or false. Alone, bumps one class; with fragility_fracture_after_40, risk_level is high. magent does not compute a steroid dose.
hip_or_spine_fragility boolean required Hip or clinical spine fragility fracture as assigned by the caller (Papaioannou 2010). true or false. When true, risk_level is high regardless of BMD. magent does not read imaging.
multiple_fragility_fractures boolean required Multiple fragility fractures as assigned by the caller (Papaioannou 2010). true or false. When true, risk_level is high regardless of BMD. magent does not take a fracture history.

Bulk (POST)

POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.

POST /api/calc/caroc Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

  • 1 to 25 items. Each item uses the same keys as the GET query parameters.
  • POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
  • 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": [
    {
      "age": "50",
      "femoral_neck_t_score": "-1.0",
      "fragility_fracture_after_40": "false",
      "hip_or_spine_fragility": "false",
      "multiple_fragility_fractures": "false",
      "prolonged_glucocorticoids": "false",
      "sex": "female"
    },
    {
      "age": "50",
      "femoral_neck_t_score": "-1.0",
      "fragility_fracture_after_40": "false",
      "hip_or_spine_fragility": "false",
      "multiple_fragility_fractures": "false",
      "prolonged_glucocorticoids": "false",
      "sex": "female"
    }
  ]
}

Open bulk paywall →

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/caroc",
  "items": [
    {
      "components": [
        {
          "factor": "hip_or_spine_fragility",
          "met": false
        },
        {
          "factor": "multiple_fragility_fractures",
          "met": false
        },
        {
          "factor": "fragility_fracture_after_40",
          "met": false
        },
        {
          "factor": "prolonged_glucocorticoids",
          "met": false
        },
        {
          "value": -1.0,
          "factor": "basal_low",
          "met": true
        },
        {
          "value": -1.0,
          "factor": "basal_moderate",
          "met": false
        },
        {
          "value": -1.0,
          "factor": "basal_high",
          "met": false
        }
      ],
      "age": 50,
      "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": "Papaioannou A, Morin S, Cheung AM, Atkinson S, Brown JP, Feldman S, et al.",
        "doi": "10.1503/cmaj.100771",
        "id": "papaioannou-2010",
        "pmid": "20937681",
        "source": "CMAJ. 2010;182(17):1864-1873",
        "title": "2010 clinical practice guidelines for the diagnosis and management of osteoporosis in Canada: summary"
      },
      "formula": "caroc",
      "formula_expression": "CAROC 2010 10-year MOF category from age, sex, and caller-assigned femoral-neck T-score, then clinical bumps. row_age = min(85, max(50, 5 * floor(age / 5))) for age 50-89. Basal low if T-score is strictly above the printed moderate floor; high if strictly below the moderate ceiling; moderate inclusive between. Women 50/55: low > -2.5, moderate -2.5 to -3.8, high < -3.8; 60: > -2.3 / -2.3 to -3.7 / < -3.7; 65: > -1.9 / -1.9 to -3.5 / < -3.5; 70: > -1.7 / -1.7 to -3.2 / < -3.2; 75: > -1.2 / -1.2 to -2.9 / < -2.9; 80: > -0.5 / -0.5 to -2.6 / < -2.6; 85: > +0.1 / +0.1 to -2.2 / < -2.2. Men 50/55: low > -2.5, moderate -2.5 to -3.9, high < -3.9; 60: > -2.5 / -2.5 to -3.7 / < -3.7; 65: > -2.4 / -2.4 to -3.7 / < -3.7; 70: > -2.3 / -2.3 to -3.7 / < -3.7; 75: > -2.3 / -2.3 to -3.8 / < -3.8; 80: > -2.1 / -2.1 to -3.8 / < -3.8; 85: > -2.0 / -2.0 to -3.8 / < -3.8. hip_or_spine_fragility or multiple_fragility_fractures → high; else fragility_fracture_after_40 and prolonged_glucocorticoids → high; else either of those two flags bumps one class (low→moderate, moderate→high). Labels: low <10%, moderate 10-20%, high >20% 10-year MOF. Papaioannou 2010 / Lentle table. Not FRAX.",
      "sex": "female",
      "basal_risk_level": "low",
      "femoral_neck_t_score": -1.0,
      "fragility_fracture_after_40": false,
      "hip_or_spine_fragility": false,
      "multiple_fragility_fractures": false,
      "prolonged_glucocorticoids": false,
      "risk_level": "low",
      "row_age": 50,
      "ten_year_mof_label": "<10%"
    },
    {
      "components": [
        {
          "factor": "hip_or_spine_fragility",
          "met": false
        },
        {
          "factor": "multiple_fragility_fractures",
          "met": false
        },
        {
          "factor": "fragility_fracture_after_40",
          "met": false
        },
        {
          "factor": "prolonged_glucocorticoids",
          "met": false
        },
        {
          "value": -1.0,
          "factor": "basal_low",
          "met": true
        },
        {
          "value": -1.0,
          "factor": "basal_moderate",
          "met": false
        },
        {
          "value": -1.0,
          "factor": "basal_high",
          "met": false
        }
      ],
      "age": 50,
      "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": "Papaioannou A, Morin S, Cheung AM, Atkinson S, Brown JP, Feldman S, et al.",
        "doi": "10.1503/cmaj.100771",
        "id": "papaioannou-2010",
        "pmid": "20937681",
        "source": "CMAJ. 2010;182(17):1864-1873",
        "title": "2010 clinical practice guidelines for the diagnosis and management of osteoporosis in Canada: summary"
      },
      "formula": "caroc",
      "formula_expression": "CAROC 2010 10-year MOF category from age, sex, and caller-assigned femoral-neck T-score, then clinical bumps. row_age = min(85, max(50, 5 * floor(age / 5))) for age 50-89. Basal low if T-score is strictly above the printed moderate floor; high if strictly below the moderate ceiling; moderate inclusive between. Women 50/55: low > -2.5, moderate -2.5 to -3.8, high < -3.8; 60: > -2.3 / -2.3 to -3.7 / < -3.7; 65: > -1.9 / -1.9 to -3.5 / < -3.5; 70: > -1.7 / -1.7 to -3.2 / < -3.2; 75: > -1.2 / -1.2 to -2.9 / < -2.9; 80: > -0.5 / -0.5 to -2.6 / < -2.6; 85: > +0.1 / +0.1 to -2.2 / < -2.2. Men 50/55: low > -2.5, moderate -2.5 to -3.9, high < -3.9; 60: > -2.5 / -2.5 to -3.7 / < -3.7; 65: > -2.4 / -2.4 to -3.7 / < -3.7; 70: > -2.3 / -2.3 to -3.7 / < -3.7; 75: > -2.3 / -2.3 to -3.8 / < -3.8; 80: > -2.1 / -2.1 to -3.8 / < -3.8; 85: > -2.0 / -2.0 to -3.8 / < -3.8. hip_or_spine_fragility or multiple_fragility_fractures → high; else fragility_fracture_after_40 and prolonged_glucocorticoids → high; else either of those two flags bumps one class (low→moderate, moderate→high). Labels: low <10%, moderate 10-20%, high >20% 10-year MOF. Papaioannou 2010 / Lentle table. Not FRAX.",
      "sex": "female",
      "basal_risk_level": "low",
      "femoral_neck_t_score": -1.0,
      "fragility_fracture_after_40": false,
      "hip_or_spine_fragility": false,
      "multiple_fragility_fractures": false,
      "prolonged_glucocorticoids": false,
      "risk_level": "low",
      "row_age": 50,
      "ten_year_mof_label": "<10%"
    }
  ]
}

Response

Field Type Description
formula string caroc
formula_expression string Published CAROC 2010 basal T-score bands and Papaioannou 2010 clinical bumps
age integer Age in years used (50-89)
sex string female or male
femoral_neck_t_score number Caller-assigned femoral-neck T-score used for the basal class
row_age integer Printed 5-year table row (50, 55, 60, 65, 70, 75, 80, or 85)
fragility_fracture_after_40 boolean Echo of the fragility-fracture-after-40 flag
prolonged_glucocorticoids boolean Echo of the prolonged-glucocorticoid flag
hip_or_spine_fragility boolean Echo of the hip-or-spine fragility flag
multiple_fragility_fractures boolean Echo of the multiple-fragility-fracture flag
basal_risk_level string low, moderate, or high from the printed T-score table before clinical bumps
risk_level string low, moderate, or high after Papaioannou 2010 bumps. Labels: low <10%, moderate 10-20%, high >20% 10-year MOF. Not FRAX. Not a bisphosphonate order.
ten_year_mof_label string Published CAROC 2010 label for risk_level: <10%, 10-20%, or >20%
components array Rows for the four clinical flags and basal_low, basal_moderate, basal_high with factor, met, and value
citation object Papaioannou 2010 CMAJ citation
disclaimer string Not-a-device notice

Example JSON

Machine form of the same example. Frozen fixture. Not a live lookup. 

{
  "components": [
    {
      "factor": "hip_or_spine_fragility",
      "met": false
    },
    {
      "factor": "multiple_fragility_fractures",
      "met": false
    },
    {
      "factor": "fragility_fracture_after_40",
      "met": false
    },
    {
      "factor": "prolonged_glucocorticoids",
      "met": false
    },
    {
      "value": -1.0,
      "factor": "basal_low",
      "met": true
    },
    {
      "value": -1.0,
      "factor": "basal_moderate",
      "met": false
    },
    {
      "value": -1.0,
      "factor": "basal_high",
      "met": false
    }
  ],
  "age": 50,
  "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": "Papaioannou A, Morin S, Cheung AM, Atkinson S, Brown JP, Feldman S, et al.",
    "doi": "10.1503/cmaj.100771",
    "id": "papaioannou-2010",
    "pmid": "20937681",
    "source": "CMAJ. 2010;182(17):1864-1873",
    "title": "2010 clinical practice guidelines for the diagnosis and management of osteoporosis in Canada: summary"
  },
  "formula": "caroc",
  "formula_expression": "CAROC 2010 10-year MOF category from age, sex, and caller-assigned femoral-neck T-score, then clinical bumps. row_age = min(85, max(50, 5 * floor(age / 5))) for age 50-89. Basal low if T-score is strictly above the printed moderate floor; high if strictly below the moderate ceiling; moderate inclusive between. Women 50/55: low > -2.5, moderate -2.5 to -3.8, high < -3.8; 60: > -2.3 / -2.3 to -3.7 / < -3.7; 65: > -1.9 / -1.9 to -3.5 / < -3.5; 70: > -1.7 / -1.7 to -3.2 / < -3.2; 75: > -1.2 / -1.2 to -2.9 / < -2.9; 80: > -0.5 / -0.5 to -2.6 / < -2.6; 85: > +0.1 / +0.1 to -2.2 / < -2.2. Men 50/55: low > -2.5, moderate -2.5 to -3.9, high < -3.9; 60: > -2.5 / -2.5 to -3.7 / < -3.7; 65: > -2.4 / -2.4 to -3.7 / < -3.7; 70: > -2.3 / -2.3 to -3.7 / < -3.7; 75: > -2.3 / -2.3 to -3.8 / < -3.8; 80: > -2.1 / -2.1 to -3.8 / < -3.8; 85: > -2.0 / -2.0 to -3.8 / < -3.8. hip_or_spine_fragility or multiple_fragility_fractures → high; else fragility_fracture_after_40 and prolonged_glucocorticoids → high; else either of those two flags bumps one class (low→moderate, moderate→high). Labels: low <10%, moderate 10-20%, high >20% 10-year MOF. Papaioannou 2010 / Lentle table. Not FRAX.",
  "sex": "female",
  "basal_risk_level": "low",
  "femoral_neck_t_score": -1.0,
  "fragility_fracture_after_40": false,
  "hip_or_spine_fragility": false,
  "multiple_fragility_fractures": false,
  "prolonged_glucocorticoids": false,
  "risk_level": "low",
  "row_age": 50,
  "ten_year_mof_label": "<10%"
}

Client errors (HTTP 400)

Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.

HTTP Code When
400 invalid_caroc CAROC 2010 inputs must match that system's age 50-85, sex, femoral-neck T-score, and yes/no fragility-fracture and glucocorticoid flags. Returned before settlement; you are not charged.
400 invalid_age age must be an integer from 18 to 120 Returned before settlement; you are not charged.
400 invalid_sex sex must be female or male 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

  • OSTA — Compute the Koh 2001 Osteoporosis Self-Assessment Tool for Asians (OSTA) as trunc(0.2 × (weight_kg − age)) toward zero, then the published low, intermediate, or high band.
  • ORAI — Sum Cadarette 2000 ORAI (age, weight, and current estrogen use) and return the Table 4 point total with select_for_dxa (score ≥9) or do_not_select.
  • OSIRIS — Compute the Sedrine 2002 Osteoporosis Index of Risk (OSIRIS) as (-0.2 × age) + (0.2 × weight_kg) + 2 if current HRT/estrogen use + (-2) if prior low-impact fracture, rounded to 1 decimal, then the published low, intermediate, or high band.

Payment

Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, 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

  • HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
  • exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. 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.