MAGENT

Lipids · LIVE

2013 PCE 10-year hard ASCVD

2013 PCE 10-year ASCVD

Compute the Goff 2013 pooled-cohort 10-year hard ASCVD percent (first hard CHD or stroke) for adults aged 40-79 from Table A sex- and cohort-specific coefficients.

LIVE $0.005 USDC GET /api/calc/ascvd_pce

Markdown: /docs/ascvd-pce.md · Canonical: https://magentlab.com/docs/ascvd-pce

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

What it computes

Compute the Goff 2013 pooled-cohort 10-year hard ASCVD percent (first hard CHD or stroke) for adults aged 40-79 from Table A sex- and cohort-specific coefficients.

When to use

When an agent already has those Goff 2013 predictors for a person aged 40-79 without prior ASCVD and needs that paper's 10-year hard ASCVD percent. Caller assigns cohort as white or african_american. Not a diagnosis, statin order, PREVENT 2024, Framingham CHD, or SCORE2.

When not to use

  • Not a medical device. Not a diagnosis of cardiovascular disease. Not a statin order, antihypertensive order, or treatment recommendation.
  • 10-year hard ASCVD (first hard CHD or stroke) only. Age 40-79. Not PREVENT 2024. Not Framingham CHD. Not SCORE2.
  • cohort is caller-assigned as white or african_american using the paper's terms. magent does not assign race or ethnicity. Recommendation 2 (use the White equations for other groups) is not applied as a silent swap; other cohort strings are rejected.
  • Treated versus untreated systolic BP uses the matching Table A coefficient. Caller assigns age, sex, cohort, lipids, blood pressure, antihypertensive, smoking, and diabetes. magent does not assay lipids and does not measure blood pressure.

Formula

10-year hard ASCVD % = 100*(1-S10**exp(individualSum-meanSum)); Goff 2013 Table A; Ln=natural log; age 40-79; cohort white|african_american (caller-assigned paper terms; not param race; Recommendation 2 is not a silent swap); treated vs untreated SBP (not both); interactions only where Table A is not N/A; WHITE WOMEN: ln_age -29.799, ln_age^2 4.884, ln_tc 13.540, ln_age*ln_tc -3.114, ln_hdl -13.578, ln_age*ln_hdl 3.149, ln_treated_sbp 2.019, ln_untreated_sbp 1.957, smoker 7.574, ln_age*smoker -1.665, diabetes 0.661, meanSum -29.18, S10 0.9665; AFRICAN AMERICAN WOMEN: ln_age 17.114, ln_tc 0.940, ln_hdl -18.920, ln_age*ln_hdl 4.475, ln_treated_sbp 29.291, ln_age*ln_treated_sbp -6.432, ln_untreated_sbp 27.820, ln_age*ln_untreated_sbp -6.087, smoker 0.691, diabetes 0.874, meanSum 86.61, S10 0.9533; WHITE MEN: ln_age 12.344, ln_tc 11.853, ln_age*ln_tc -2.664, ln_hdl -7.990, ln_age*ln_hdl 1.769, ln_treated_sbp 1.797, ln_untreated_sbp 1.764, smoker 7.837, ln_age*smoker -1.795, diabetes 0.658, meanSum 61.18, S10 0.9144; AFRICAN AMERICAN MEN: ln_age 2.469, ln_tc 0.302, ln_hdl -0.307, ln_treated_sbp 1.916, ln_untreated_sbp 1.809, smoker 0.549, diabetes 0.645, meanSum 19.54, S10 0.8954; round 1 decimal; not PREVENT 2024; not Framingham CHD; not SCORE2; not a statin order

Citation

Title
2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk: A Report of the American College of Cardiology/American Heart Association Task Force on Practice Guidelines
Authors
Goff DC Jr, Lloyd-Jones DM, Bennett G, Coady S, D'Agostino RB, Gibbons R, Greenland P, Lackland DT, Levy D, O'Donnell CJ, Robinson JG, Schwartz JS, Shero ST, Smith SC Jr, Sorlie P, Stone NJ, Wilson PW
Source
Circulation. 2014;129(25 Suppl 2):S49-S73
DOI
10.1161/01.cir.0000437741.48606.98

Worked example

Paper 55-year-old white woman, TC 213, HDL 50, untreated SBP 120, nonsmoker, nondiabetic

Given: age=55antihypertensive=falsecohort=whitediabetes=falsehdl_mg_dl=50sbp_mm_hg=120sex=femalesmoker=falsetotal_cholesterol_mg_dl=213

  1. ln(age)=ln(55), ln(TC)=ln(213), ln(HDL)=ln(50), ln(untreated SBP)=ln(120); WHITE WOMEN Table A
  2. individual_sum -29.6767
  3. ten_year_ascvd_percent 2.1 (paper vignette 2.1%)

Same labs, african_american woman

Given: age=55antihypertensive=falsecohort=african_americandiabetes=falsehdl_mg_dl=50sbp_mm_hg=120sex=femalesmoker=falsetotal_cholesterol_mg_dl=213

  1. AFRICAN AMERICAN WOMEN Table A (no ln_age^2, no ln_age×ln_tc, no ln_age×smoker)
  2. individual_sum 86.1677; ten_year_ascvd_percent 3.0 (paper vignette 3.0%)

Same labs, white man

Given: age=55antihypertensive=falsecohort=whitediabetes=falsehdl_mg_dl=50sbp_mm_hg=120sex=malesmoker=falsetotal_cholesterol_mg_dl=213

  1. WHITE MEN Table A (no ln_age^2; no age×SBP interaction)
  2. individual_sum 60.6995; ten_year_ascvd_percent 5.4

Same labs, african_american man

Given: age=55antihypertensive=falsecohort=african_americandiabetes=falsehdl_mg_dl=50sbp_mm_hg=120sex=malesmoker=falsetotal_cholesterol_mg_dl=213

  1. AFRICAN AMERICAN MEN Table A (no age-lipid, age-smoker, or age-SBP interactions)
  2. individual_sum 18.9728; ten_year_ascvd_percent 6.1 (paper vignette 6.1%)

Same white woman, treated SBP 120

Given: age=55antihypertensive=truecohort=whitediabetes=falsehdl_mg_dl=50sbp_mm_hg=120sex=femalesmoker=falsetotal_cholesterol_mg_dl=213

  1. antihypertensive true uses WHITE WOMEN ln_treated_sbp 2.019 instead of ln_untreated_sbp 1.957
  2. individual_sum -29.3798; ten_year_ascvd_percent 2.8

Also searched as

  • pooled cohort equations
  • 2013 ACC/AHA ASCVD
  • 10-year hard ASCVD
  • Goff 2013 Circulation
  • PCE ASCVD risk
  • treated SBP pooled cohort
  • african_american PCE

Try

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

/api/calc/ascvd_pce?age=55&sex=female&cohort=white&total_cholesterol_mg_dl=213&hdl_mg_dl=50&sbp_mm_hg=120&antihypertensive=false&smoker=false&diabetes=false

Full URL: https://api.magentlab.com/api/calc/ascvd_pce?age=55&sex=female&cohort=white&total_cholesterol_mg_dl=213&hdl_mg_dl=50&sbp_mm_hg=120&antihypertensive=false&smoker=false&diabetes=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/ascvd_pce?age=55&sex=female&cohort=white&total_cholesterol_mg_dl=213&hdl_mg_dl=50&sbp_mm_hg=120&antihypertensive=false&smoker=false&diabetes=false"

Parameters

Name Type Required Description
age integer required Age in years (integer 40-79). Goff 2013 Table A 10-year hard ASCVD is for ages 40-79. magent does not take a date of birth.
sex string required · female, male Sex used by the sex-specific Table A coefficients (female or male). Not cohort.
cohort string required · white, african_american Caller-assigned cohort as used in Goff 2013 Table A: white or african_american (paper terms). Not param race. magent does not assign race or ethnicity. Recommendation 2 (use the White equations for other groups) is not applied as a silent swap; other strings are rejected.
total_cholesterol_mg_dl number required Total cholesterol in mg/dL (50-800). Enters as ln(total cholesterol). magent does not assay lipids.
hdl_mg_dl number required HDL cholesterol in mg/dL (5-150). Enters as ln(HDL-C). magent does not assay lipids.
sbp_mm_hg number required Systolic blood pressure in mm Hg (50-250). Enters as ln(SBP) with the treated or untreated Table A coefficient according to antihypertensive. magent does not measure blood pressure.
antihypertensive boolean required Current antihypertensive treatment as assigned by the caller (true or false). true uses the Table A treated-SBP coefficient (and age × treated SBP when that cell is not N/A). false uses untreated SBP. Not both.
smoker boolean required Current cigarette smoking as assigned by the caller (true or false). Adds the Table A smoker term and ln(age) × smoker when that cell is not N/A. magent does not take a smoking history.
diabetes boolean required Diabetes as assigned by the caller (true or false). Adds the Table A diabetes term. magent does not assay glucose.

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/ascvd_pce 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": "55",
      "antihypertensive": "false",
      "cohort": "white",
      "diabetes": "false",
      "hdl_mg_dl": "50",
      "sbp_mm_hg": "120",
      "sex": "female",
      "smoker": "false",
      "total_cholesterol_mg_dl": "213"
    },
    {
      "age": "55",
      "antihypertensive": "false",
      "cohort": "white",
      "diabetes": "false",
      "hdl_mg_dl": "50",
      "sbp_mm_hg": "120",
      "sex": "female",
      "smoker": "false",
      "total_cholesterol_mg_dl": "213"
    }
  ]
}

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/ascvd_pce",
  "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": "Goff DC Jr, Lloyd-Jones DM, Bennett G, Coady S, D'Agostino RB, Gibbons R, Greenland P, Lackland DT, Levy D, O'Donnell CJ, Robinson JG, Schwartz JS, Shero ST, Smith SC Jr, Sorlie P, Stone NJ, Wilson PW",
        "doi": "10.1161/01.cir.0000437741.48606.98",
        "id": "goff-2013-pce",
        "pmid": "24222018",
        "source": "Circulation. 2014;129(25 Suppl 2):S49-S73",
        "title": "2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk: A Report of the American College of Cardiology/American Heart Association Task Force on Practice Guidelines"
      },
      "formula": "ascvd_pce",
      "formula_expression": "10-year hard ASCVD % = 100*(1-S10**exp(individualSum-meanSum)); Goff 2013 Table A; Ln=natural log; age 40-79; cohort white|african_american (caller-assigned paper terms; not param race; Recommendation 2 is not a silent swap); treated vs untreated SBP (not both); interactions only where Table A is not N/A; WHITE WOMEN: ln_age -29.799, ln_age^2 4.884, ln_tc 13.540, ln_age*ln_tc -3.114, ln_hdl -13.578, ln_age*ln_hdl 3.149, ln_treated_sbp 2.019, ln_untreated_sbp 1.957, smoker 7.574, ln_age*smoker -1.665, diabetes 0.661, meanSum -29.18, S10 0.9665; AFRICAN AMERICAN WOMEN: ln_age 17.114, ln_tc 0.940, ln_hdl -18.920, ln_age*ln_hdl 4.475, ln_treated_sbp 29.291, ln_age*ln_treated_sbp -6.432, ln_untreated_sbp 27.820, ln_age*ln_untreated_sbp -6.087, smoker 0.691, diabetes 0.874, meanSum 86.61, S10 0.9533; WHITE MEN: ln_age 12.344, ln_tc 11.853, ln_age*ln_tc -2.664, ln_hdl -7.990, ln_age*ln_hdl 1.769, ln_treated_sbp 1.797, ln_untreated_sbp 1.764, smoker 7.837, ln_age*smoker -1.795, diabetes 0.658, meanSum 61.18, S10 0.9144; AFRICAN AMERICAN MEN: ln_age 2.469, ln_tc 0.302, ln_hdl -0.307, ln_treated_sbp 1.916, ln_untreated_sbp 1.809, smoker 0.549, diabetes 0.645, meanSum 19.54, S10 0.8954; round 1 decimal; not PREVENT 2024; not Framingham CHD; not SCORE2; not a statin order",
      "sex": "female",
      "antihypertensive": false,
      "cohort": "white",
      "diabetes": false,
      "hdl_mg_dl": 50.0,
      "individual_sum": -29.6767,
      "sbp_mm_hg": 120.0,
      "smoker": false,
      "ten_year_ascvd_percent": 2.1,
      "total_cholesterol_mg_dl": 213.0
    },
    {
      "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": "Goff DC Jr, Lloyd-Jones DM, Bennett G, Coady S, D'Agostino RB, Gibbons R, Greenland P, Lackland DT, Levy D, O'Donnell CJ, Robinson JG, Schwartz JS, Shero ST, Smith SC Jr, Sorlie P, Stone NJ, Wilson PW",
        "doi": "10.1161/01.cir.0000437741.48606.98",
        "id": "goff-2013-pce",
        "pmid": "24222018",
        "source": "Circulation. 2014;129(25 Suppl 2):S49-S73",
        "title": "2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk: A Report of the American College of Cardiology/American Heart Association Task Force on Practice Guidelines"
      },
      "formula": "ascvd_pce",
      "formula_expression": "10-year hard ASCVD % = 100*(1-S10**exp(individualSum-meanSum)); Goff 2013 Table A; Ln=natural log; age 40-79; cohort white|african_american (caller-assigned paper terms; not param race; Recommendation 2 is not a silent swap); treated vs untreated SBP (not both); interactions only where Table A is not N/A; WHITE WOMEN: ln_age -29.799, ln_age^2 4.884, ln_tc 13.540, ln_age*ln_tc -3.114, ln_hdl -13.578, ln_age*ln_hdl 3.149, ln_treated_sbp 2.019, ln_untreated_sbp 1.957, smoker 7.574, ln_age*smoker -1.665, diabetes 0.661, meanSum -29.18, S10 0.9665; AFRICAN AMERICAN WOMEN: ln_age 17.114, ln_tc 0.940, ln_hdl -18.920, ln_age*ln_hdl 4.475, ln_treated_sbp 29.291, ln_age*ln_treated_sbp -6.432, ln_untreated_sbp 27.820, ln_age*ln_untreated_sbp -6.087, smoker 0.691, diabetes 0.874, meanSum 86.61, S10 0.9533; WHITE MEN: ln_age 12.344, ln_tc 11.853, ln_age*ln_tc -2.664, ln_hdl -7.990, ln_age*ln_hdl 1.769, ln_treated_sbp 1.797, ln_untreated_sbp 1.764, smoker 7.837, ln_age*smoker -1.795, diabetes 0.658, meanSum 61.18, S10 0.9144; AFRICAN AMERICAN MEN: ln_age 2.469, ln_tc 0.302, ln_hdl -0.307, ln_treated_sbp 1.916, ln_untreated_sbp 1.809, smoker 0.549, diabetes 0.645, meanSum 19.54, S10 0.8954; round 1 decimal; not PREVENT 2024; not Framingham CHD; not SCORE2; not a statin order",
      "sex": "female",
      "antihypertensive": false,
      "cohort": "white",
      "diabetes": false,
      "hdl_mg_dl": 50.0,
      "individual_sum": -29.6767,
      "sbp_mm_hg": 120.0,
      "smoker": false,
      "ten_year_ascvd_percent": 2.1,
      "total_cholesterol_mg_dl": 213.0
    }
  ]
}

Response

Field Type Description
formula string ascvd_pce
formula_expression string Goff 2013 Table A sex- and cohort-specific 10-year hard ASCVD
age integer Age in years used (40-79)
sex string female or male used
cohort string Caller-assigned white or african_american used
total_cholesterol_mg_dl number Total cholesterol used, mg/dL
hdl_mg_dl number HDL-C used, mg/dL
sbp_mm_hg number Systolic BP used, mm Hg
antihypertensive boolean Caller-assigned antihypertensive treatment used
smoker boolean Caller-assigned current smoking used
diabetes boolean Caller-assigned diabetes used
individual_sum number Table A Coefficient×Value individual sum, 4 decimals
ten_year_ascvd_percent number 10-year hard ASCVD percent, 1 decimal
citation object Goff et al. Circulation 2014 citation
disclaimer string Not-a-device notice

Example JSON

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

{
  "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": "Goff DC Jr, Lloyd-Jones DM, Bennett G, Coady S, D'Agostino RB, Gibbons R, Greenland P, Lackland DT, Levy D, O'Donnell CJ, Robinson JG, Schwartz JS, Shero ST, Smith SC Jr, Sorlie P, Stone NJ, Wilson PW",
    "doi": "10.1161/01.cir.0000437741.48606.98",
    "id": "goff-2013-pce",
    "pmid": "24222018",
    "source": "Circulation. 2014;129(25 Suppl 2):S49-S73",
    "title": "2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk: A Report of the American College of Cardiology/American Heart Association Task Force on Practice Guidelines"
  },
  "formula": "ascvd_pce",
  "formula_expression": "10-year hard ASCVD % = 100*(1-S10**exp(individualSum-meanSum)); Goff 2013 Table A; Ln=natural log; age 40-79; cohort white|african_american (caller-assigned paper terms; not param race; Recommendation 2 is not a silent swap); treated vs untreated SBP (not both); interactions only where Table A is not N/A; WHITE WOMEN: ln_age -29.799, ln_age^2 4.884, ln_tc 13.540, ln_age*ln_tc -3.114, ln_hdl -13.578, ln_age*ln_hdl 3.149, ln_treated_sbp 2.019, ln_untreated_sbp 1.957, smoker 7.574, ln_age*smoker -1.665, diabetes 0.661, meanSum -29.18, S10 0.9665; AFRICAN AMERICAN WOMEN: ln_age 17.114, ln_tc 0.940, ln_hdl -18.920, ln_age*ln_hdl 4.475, ln_treated_sbp 29.291, ln_age*ln_treated_sbp -6.432, ln_untreated_sbp 27.820, ln_age*ln_untreated_sbp -6.087, smoker 0.691, diabetes 0.874, meanSum 86.61, S10 0.9533; WHITE MEN: ln_age 12.344, ln_tc 11.853, ln_age*ln_tc -2.664, ln_hdl -7.990, ln_age*ln_hdl 1.769, ln_treated_sbp 1.797, ln_untreated_sbp 1.764, smoker 7.837, ln_age*smoker -1.795, diabetes 0.658, meanSum 61.18, S10 0.9144; AFRICAN AMERICAN MEN: ln_age 2.469, ln_tc 0.302, ln_hdl -0.307, ln_treated_sbp 1.916, ln_untreated_sbp 1.809, smoker 0.549, diabetes 0.645, meanSum 19.54, S10 0.8954; round 1 decimal; not PREVENT 2024; not Framingham CHD; not SCORE2; not a statin order",
  "sex": "female",
  "antihypertensive": false,
  "cohort": "white",
  "diabetes": false,
  "hdl_mg_dl": 50.0,
  "individual_sum": -29.6767,
  "sbp_mm_hg": 120.0,
  "smoker": false,
  "ten_year_ascvd_percent": 2.1,
  "total_cholesterol_mg_dl": 213.0
}

Client errors (HTTP 400)

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

HTTP Code When
400 invalid_ascvd_pce 2013 PCE inputs must match Goff 2013 age 40-79, sex, white or african_american cohort, lipids, treated or untreated SBP, smoking, and diabetes. 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

  • PREVENT 10-year total CVD — Compute the Khan 2024 PREVENT base 10-year total CVD percent (ASCVD plus heart failure) for adults aged 30-79 from sex-specific, race-free Table S12 coefficients.
  • Framingham CHD — Sum Wilson 1998 sex-specific total-cholesterol point sheets (age, TC, HDL, JNC-V blood pressure, diabetes, smoking) and return the published 10-year CHD percent.
  • SCORE2 10-year CVD risk — Compute the ESC 2021 SCORE2 10-year fatal plus non-fatal CVD percent for adults aged 40-69 from sex, current smoking, systolic blood pressure, non-HDL cholesterol, and European geographic risk region.

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.