# OSIRIS osteoporosis index of risk OSIRIS Status: LIVE Price: $0.005 USDC `GET /api/calc/osiris` HTML: https://magentlab.com/docs/osiris Markdown: https://magentlab.com/docs/osiris.md Not a medical device. Not a diagnosis, dose, or listing recommendation. ## What it computes 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. ## When to use When an agent has age, weight, current HRT/estrogen use, and prior low-impact fracture history and needs the published Sedrine 2002 OSIRIS index and band, not FRAX, not a DXA order, and not a diagnosis of osteoporosis. ## When not to use - Not a medical device. Not a diagnosis of osteoporosis. magent does not examine the patient. - Not FRAX and not a DXA order. magent returns the Sedrine 2002 OSIRIS index and published band only. - Sedrine 2002 derivation was postmenopausal Western European women. That is a limitation, not a race input. magent does not restrict sex or ethnicity at input. ## Formula ``` OSIRIS = (-0.2 * age) + (0.2 * weight_kg) + (2 if current_hrt) + (-2 if prior_low_impact_fracture); low if score > +1; high if score < -3; intermediate otherwise (including exact +1 and exact -3) ``` ## Citation [Development and assessment of the Osteoporosis Index of Risk (OSIRIS) to facilitate selection of women for bone densitometry](https://doi.org/10.1080/gye.16.3.245.250) Sedrine WB, Chevallier T, Zegels B, Kvasz A, Micheletti MC, Gelas B, Reginster JY Gynecol Endocrinol. 2002;16(3):245-250 DOI: [10.1080/gye.16.3.245.250](https://doi.org/10.1080/gye.16.3.245.250) ## Worked example ### 55 years, 70 kg, current HRT, no prior low-impact fracture (low) Given: `age=55, current_hrt=true, prior_low_impact_fracture=false, weight_kg=70` 1. (-0.2 × 55) + (0.2 × 70) + 2 + 0 = -11.0 + 14.0 + 2.0 = 5.0 2. round to 1 decimal → 5.0 3. score 5.0 > +1 → low ### 65 years, 55 kg, no HRT, no prior low-impact fracture (intermediate) Given: `age=65, current_hrt=false, prior_low_impact_fracture=false, weight_kg=55` 1. (-0.2 × 65) + (0.2 × 55) + 0 + 0 = -13.0 + 11.0 = -2.0 2. score -2.0 is not > +1 and not < -3 → intermediate ### 75 years, 50 kg, no HRT, prior low-impact fracture (high) Given: `age=75, current_hrt=false, prior_low_impact_fracture=true, weight_kg=50` 1. (-0.2 × 75) + (0.2 × 50) + 0 + (-2) = -15.0 + 10.0 - 2.0 = -7.0 2. score -7.0 < -3 → high ## Also searched as - OSIRIS - Osteoporosis Index of Risk - Sedrine OSIRIS - OSIRIS osteoporosis - HRT osteoporosis index - low-impact fracture osteoporosis index - bone densitometry selection - postmenopausal osteoporosis index ## Parameters - `age` (integer, required): Age in years (18-120). Sedrine 2002 OSIRIS uses age as a whole number of years. - `weight_kg` (number, optional): Weight in kilograms. Provide weight_kg or weight_lb. - `weight_lb` (number, optional): Weight in pounds. Converted as kg = lb * 0.45359237. - `current_hrt` (boolean, required): Current HRT/estrogen use (Sedrine 2002). true adds +2; false adds 0. true or false. - `prior_low_impact_fracture` (boolean, required): Prior low-impact fracture (Sedrine 2002). true adds -2; false adds 0. true or false. ## 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. Method: `POST /api/calc/osiris` Max items: 25 Price: unit_amount + extra_item_amount * (n - 1) (unit 5000 atomic, extra 2000 atomic) Status: 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: ```json { "items": [ { "age": "55", "current_hrt": "true", "prior_low_impact_fracture": "false", "weight_kg": "70" }, { "age": "55", "current_hrt": "true", "prior_low_impact_fracture": "false", "weight_kg": "70" } ] } ``` Human paywall (two-item fixture): https://api.magentlab.com/paywall/bulk/osiris Example 200: ```json { "count": 2, "path": "/api/calc/osiris", "items": [ { "age": 55, "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": "Sedrine WB, Chevallier T, Zegels B, Kvasz A, Micheletti MC, Gelas B, Reginster JY", "doi": "10.1080/gye.16.3.245.250", "id": "sedrine-2002", "pmid": "12192897", "source": "Gynecol Endocrinol. 2002;16(3):245-250", "title": "Development and assessment of the Osteoporosis Index of Risk (OSIRIS) to facilitate selection of women for bone densitometry" }, "formula": "osiris", "formula_expression": "OSIRIS = (-0.2 * age) + (0.2 * weight_kg) + (2 if current_hrt) + (-2 if prior_low_impact_fracture); low if score > +1; high if score < -3; intermediate otherwise (including exact +1 and exact -3)", "weight_kg": 70.0, "risk": "low", "current_hrt": true, "osiris_index": 5.0, "prior_low_impact_fracture": false }, { "age": 55, "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": "Sedrine WB, Chevallier T, Zegels B, Kvasz A, Micheletti MC, Gelas B, Reginster JY", "doi": "10.1080/gye.16.3.245.250", "id": "sedrine-2002", "pmid": "12192897", "source": "Gynecol Endocrinol. 2002;16(3):245-250", "title": "Development and assessment of the Osteoporosis Index of Risk (OSIRIS) to facilitate selection of women for bone densitometry" }, "formula": "osiris", "formula_expression": "OSIRIS = (-0.2 * age) + (0.2 * weight_kg) + (2 if current_hrt) + (-2 if prior_low_impact_fracture); low if score > +1; high if score < -3; intermediate otherwise (including exact +1 and exact -3)", "weight_kg": 70.0, "risk": "low", "current_hrt": true, "osiris_index": 5.0, "prior_low_impact_fracture": false } ] } ``` ## Response fields - `formula` (string): osiris - `formula_expression` (string): Exact Sedrine 2002 expression - `age` (integer): Age in years used in the index - `weight_kg` (number): Normalized weight in kg - `current_hrt` (boolean): Current HRT/estrogen use used in the index - `prior_low_impact_fracture` (boolean): Prior low-impact fracture used in the index - `osiris_index` (number): Sedrine 2002 OSIRIS index, 1 decimal. Not truncated like OSTA. Not FRAX. - `risk` (string): low (score > +1), high (score < -3), or intermediate otherwise including exact +1 and exact -3. Sedrine 2002 published band, not a diagnosis or DXA order. - `citation` (object): Sedrine 2002 Gynecol Endocrinol citation - `disclaimer` (string): Not-a-device notice ## Example JSON Frozen fixture. Not a live lookup. ```json { "age": 55, "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": "Sedrine WB, Chevallier T, Zegels B, Kvasz A, Micheletti MC, Gelas B, Reginster JY", "doi": "10.1080/gye.16.3.245.250", "id": "sedrine-2002", "pmid": "12192897", "source": "Gynecol Endocrinol. 2002;16(3):245-250", "title": "Development and assessment of the Osteoporosis Index of Risk (OSIRIS) to facilitate selection of women for bone densitometry" }, "formula": "osiris", "formula_expression": "OSIRIS = (-0.2 * age) + (0.2 * weight_kg) + (2 if current_hrt) + (-2 if prior_low_impact_fracture); low if score > +1; high if score < -3; intermediate otherwise (including exact +1 and exact -3)", "weight_kg": 70.0, "risk": "low", "current_hrt": true, "osiris_index": 5.0, "prior_low_impact_fracture": false } ``` ## Errors - HTTP 400 `invalid_age`: age must be an integer from 18 to 120 Returned before settlement; you are not charged. - HTTP 400 `invalid_weight`: weight_kg (1-500) or weight_lb (2-1100) is required Returned before settlement; you are not charged. - HTTP 400 `invalid_flag`: boolean clinical flags must be true or false Returned before settlement; you are not charged. - HTTP 400 `invalid_items`: POST body must be a JSON object with only an items array Returned before settlement; you are not charged. - HTTP 400 `invalid_item_count`: items must be an array of 1 to 25 objects Returned before settlement; you are not charged. - HTTP 400 `invalid_item`: each items entry must be a JSON object Returned before settlement; you are not charged. Shared HTTP 402 and 503: https://magentlab.com/docs/payments ## Related tools - [OSTA](https://magentlab.com/docs/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. - [BMI](https://magentlab.com/docs/bmi) — Compute Keys/Quetelet body-mass index from height and weight, plus a WHO adult 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. - GET the tool with Accept: application/json (do not send Accept: text/html unless you want the human paywall). - HTTP 402 means you have not paid. Decode the base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote. - Sign accepts[0] (exact, EIP-3009) with validBefore = now + maxTimeoutSeconds (600 seconds), or accepts[1] (batch-settlement deposit/voucher) on product GET. Ping and POST {items} stay exact. Magent retries transient facilitator 429/5xx before answering. - Retry the same URL with PAYMENT-SIGNATURE (base64 JSON of accepted and payload). Magent attaches canonical extensions.bazaar on CDP verify/settle; echoing 402 bazaar is optional. - Success is HTTP 200 JSON plus PAYMENT-RESPONSE. exact settles before the tool. batch-settlement verifies (and deposit-settles) before the tool and commits the charge after HTTP 2xx. HTTP 503: retry the same PAYMENT-SIGNATURE. Mint a new exact nonce only after a new HTTP 402. - offered `exact` on eip155:8453: Fixed-price USDC on Base. The buyer authorizes the advertised amount (EIP-3009). magent settles before the tool runs (paymentFlow upfront). extra.assetTransferMethod=eip3009 extra.paymentFlow=upfront. - offered `batch-settlement` on eip155:8453: Payment-channel vouchers claimed later in batches. Exact stays accepts[0]. Same-path POST {items} is still exact. extra.assetTransferMethod=eip3009 extra.paymentFlow=authorization. - not offered `upto`: Not offered. Usage-based: buyer authorizes a ceiling, seller settles the actual amount after work. Reserved for a future metered tool. Not for current calculators or code search. Same-path POST {items} is still scheme exact: one EIP-3009 authorization for GET unit plus $0.002 per extra item. That is not x402 batch-settlement (payment channels / vouchers). Shared HTTP 402 and 503 table: https://magentlab.com/docs/payments Stdio MCP (one process per host): https://magentlab.com/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.