MAGENT

Neonatal · LIVE

Neonatal partial-exchange volume

Compute the Kumar 2004 partial-exchange transfusion volume from actual hematocrit and caller-assigned blood volume, using the trial's printed desired hematocrit of 55 percent.

LIVE $0.005 USDC GET /api/calc/neonatal_partial_exchange

Markdown: /docs/neonatal-partial-exchange.md · Canonical: https://magentlab.com/docs/neonatal-partial-exchange

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

What it computes

Compute the Kumar 2004 partial-exchange transfusion volume from actual hematocrit and caller-assigned blood volume, using the trial's printed desired hematocrit of 55 percent.

When to use

When an agent needs the published Kumar 2004 PET volume and must not invent a blood-volume nomogram, a desired hematocrit other than 55 percent, a saline-versus-plasma choice, or an indication for exchange.

When not to use

  • Not a medical device. Not a transfusion order.
  • Desired hematocrit is the trial's 55 percent only. magent does not implement a blood-volume nomogram or choose millilitres per kilogram.
  • magent does not choose saline versus plasma.
  • Not an indication. The trial found no long-term benefit in asymptomatic LBW infants.

Formula

volume_ml = (actual_hct_percent - 55) / actual_hct_percent * blood_volume_ml

Citation

Title
Effect of partial exchange transfusion in asymptomatic polycythemic LBW babies
Authors
Kumar A, Ramji S
Source
Indian Pediatr. 2004;41(4):366-372
DOI
none

Worked example

Hct 70 percent, blood volume 270 mL

Given: actual_hct_percent=70blood_volume_ml=270

  1. volume_ml = (70 - 55) / 70 * 270 = 15 / 70 * 270 = 57.9

Hct 80 percent, blood volume 240 mL

Given: actual_hct_percent=80blood_volume_ml=240

  1. volume_ml = (80 - 55) / 80 * 240 = 75.0

Also searched as

  • neonatal partial exchange
  • partial exchange transfusion
  • PET volume
  • polycythemia exchange volume
  • Kumar 2004 partial exchange
  • neonatal hematocrit exchange
  • LBW partial exchange

Try

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

/api/calc/neonatal_partial_exchange?actual_hct_percent=70&blood_volume_ml=270

Full URL: https://api.magentlab.com/api/calc/neonatal_partial_exchange?actual_hct_percent=70&blood_volume_ml=270

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/neonatal_partial_exchange?actual_hct_percent=70&blood_volume_ml=270"

Parameters

Name Type Required Description
actual_hct_percent number required Actual hematocrit as percent (56-90). Must be above the trial desired 55.
blood_volume_ml number required Caller-assigned blood volume in millilitres (40-600). magent does not choose millilitres per kilogram.

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/neonatal_partial_exchange 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": [
    {
      "actual_hct_percent": "70",
      "blood_volume_ml": "270"
    },
    {
      "actual_hct_percent": "70",
      "blood_volume_ml": "270"
    }
  ]
}

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/neonatal_partial_exchange",
  "items": [
    {
      "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": "Kumar A, Ramji S",
        "id": "kumar-2004",
        "pmid": "15123865",
        "source": "Indian Pediatr. 2004;41(4):366-372",
        "title": "Effect of partial exchange transfusion in asymptomatic polycythemic LBW babies"
      },
      "formula": "neonatal_partial_exchange",
      "formula_expression": "volume_ml = (actual_hct_percent - 55) / actual_hct_percent * blood_volume_ml",
      "volume_ml": 57.9,
      "blood_volume_ml": 270.0,
      "actual_hct_percent": 70.0,
      "desired_hct_percent": 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": "Kumar A, Ramji S",
        "id": "kumar-2004",
        "pmid": "15123865",
        "source": "Indian Pediatr. 2004;41(4):366-372",
        "title": "Effect of partial exchange transfusion in asymptomatic polycythemic LBW babies"
      },
      "formula": "neonatal_partial_exchange",
      "formula_expression": "volume_ml = (actual_hct_percent - 55) / actual_hct_percent * blood_volume_ml",
      "volume_ml": 57.9,
      "blood_volume_ml": 270.0,
      "actual_hct_percent": 70.0,
      "desired_hct_percent": 55
    }
  ]
}

Response

Field Type Description
formula string neonatal_partial_exchange
formula_expression string Exact expression used
actual_hct_percent number Input actual hematocrit in percent
blood_volume_ml number Caller-assigned blood volume in mL
desired_hct_percent number Kumar 2004 printed desired hematocrit (55)
volume_ml number Partial-exchange volume in mL, 1 decimal
citation object Kumar and Ramji 2004 citation
disclaimer string Not-a-device notice

Example JSON

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

{
  "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": "Kumar A, Ramji S",
    "id": "kumar-2004",
    "pmid": "15123865",
    "source": "Indian Pediatr. 2004;41(4):366-372",
    "title": "Effect of partial exchange transfusion in asymptomatic polycythemic LBW babies"
  },
  "formula": "neonatal_partial_exchange",
  "formula_expression": "volume_ml = (actual_hct_percent - 55) / actual_hct_percent * blood_volume_ml",
  "volume_ml": 57.9,
  "blood_volume_ml": 270.0,
  "actual_hct_percent": 70.0,
  "desired_hct_percent": 55
}

Client errors (HTTP 400)

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

HTTP Code When
400 invalid_pet Partial-exchange inputs must match Kumar 2004 actual hematocrit above 55 percent and caller-assigned blood volume from that trial. 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

  • Neonatal glucose infusion rate — Compute neonatal glucose infusion rate in mg/kg/min from dextrose concentration and infusion rate using the unit conversion used with the 2011 AAP postnatal glucose homeostasis report.
  • Pregnancy due date from LMP — Return ACOG Committee Opinion 700 Naegele estimated due date in days from a certain last menstrual period, adjusting the 280-day interval when cycle length is not 28 days.
  • RhIG vials — Compute ACOG Practice Bulletin 181 RhD immune globulin vial count from caller-assigned fetal-cell percent and maternal blood volume using AABB Technical Manual rounding of FMH/30.

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.