{"uid":"cap_RRblO2z6zEy6MCvEWflJZ","slug":"beam-calculator-zisman-2016-31daba99","name":"BeAM Calculator (Zisman 2016)","description":"BeAM (bedtime minus pre-breakfast glucose) in mg/dL from Zisman 2016. Provide bedtime_glucose_mg_dl or bedtime_glucose_mmol_l independently of AM, and am_glucose_mg_dl or am_glucose_mmol_l. mmol/L converts as mg/dL = mmol/L × 18. Returns beam_mg_dl (1 decimal) and the published analysis band (<0, 0-50, >50). 0 and 50 are 0-50. Does not use a 45 or 55 cutoff, order prandial insulin, or diagnose diabetes.","url":"https://api.magentlab.com/api/calc/beam","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":[],"properties":{"am_glucose_mg_dl":{"type":"number","description":"Pre-breakfast (AM) glucose in mg/dL (40-600). Provide this or am_glucose_mmol_l, not both. Independent of the bedtime unit."},"am_glucose_mmol_l":{"type":"number","description":"Pre-breakfast (AM) glucose in mmol/L (2.2-33.3). Converted as mg/dL = mmol/L × 18. Provide this or am_glucose_mg_dl, not both."},"bedtime_glucose_mg_dl":{"type":"number","description":"Bedtime glucose in mg/dL (40-600). Provide this or bedtime_glucose_mmol_l, not both. Independent of the AM unit."},"bedtime_glucose_mmol_l":{"type":"number","description":"Bedtime glucose in mmol/L (2.2-33.3). Converted as mg/dL = mmol/L × 18 (same factor as HOMA-IR). Provide this or bedtime_glucose_mg_dl, not both."}}}},"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_s5b0o0DQzuy3rI3khR2Ql","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":"Calculates the BeAM score (bedtime minus pre-breakfast AM glucose in mg/dL) and returns the published Zisman 2016 analysis band (<0, 0–50, >50).","exampleAgentPrompt":"My bedtime glucose was 165 mg/dL and my fasting pre-breakfast glucose this morning was 110 mg/dL — can you calculate my BeAM score and tell me which Zisman 2016 band it falls into?","exampleUseCases":[{"title":"Overnight glucose drop assessment","prompt":"My bedtime reading was 9.2 mmol/L and my fasting glucose this morning was 5.8 mmol/L — what is my BeAM score and which analysis band does it land in?"},{"title":"Basal insulin titration review","prompt":"The patient had a bedtime glucose of 210 mg/dL and a pre-breakfast glucose of 145 mg/dL this morning — compute the BeAM score and tell me if it's below zero, between 0 and 50, or above 50 per Zisman 2016."},{"title":"Unit-mixed glucose log entry","prompt":"I logged my bedtime sugar as 7.8 mmol/L but my morning fasting was recorded as 98 mg/dL — please calculate the BeAM value for me in mg/dL."}],"resultDescription":"Returns beam_mg_dl rounded to one decimal place (bedtime glucose minus AM glucose), along with the Zisman 2016 analysis band classification: less than 0, 0–50 (inclusive of 0 and 50), or greater than 50.","failureModes":["Missing both bedtime glucose inputs — requires either bedtime_glucose_mg_dl or bedtime_glucose_mmol_l","Missing both AM glucose inputs — requires either am_glucose_mg_dl or am_glucose_mmol_l","Both unit variants provided for the same measurement (e.g. both mg/dL and mmol/L for bedtime) — only one should be supplied","Glucose value out of accepted range (40–600 mg/dL / 2.2–33.3 mmol/L) — may return validation error","Payment not included or rejected — x402 payment required at $0.005 USDC per call"],"whenToPreferThis":"Choose this endpoint when you need to compute the standardized BeAM metric exactly as defined by Zisman 2016, including proper band classification at 0 and 50 thresholds. It handles mixed units (mg/dL and mmol/L independently per measurement), making it useful when patient data comes from different device systems. Prefer it over manual subtraction when you need a validated, auditable clinical calculation with the published band label attached.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:13:58.958Z","isFirstParty":false}