1. Install the NPM library
npm install @longevity-tools/platform-sdk2. Provide the biomarkers
Please consult the documentation for integration details: README.md
Use the below tables to build your biomarkerIdDictionary mapping for markers not automatically paired by LOINC codes.
Enum Biomarkers
For enum biomarkers, please provide one of the valid values exactly as listed here.
| ID | NAME | LOINCs | VALID VALUES |
|---|---|---|---|
| Rx-antihypertensive | Blood Pressure Medication Antihypertensive medication use | — | noyes |
| gender | Gender | — | malefemale |
| Dx-diabetes | History of diabetes | — | noyes |
| Rx-lipidLowering | Lipid-Lowering Medication Lipid-lowering medication use | — | noyes |
| race | Race | — | asianblackhispanicwhite |
| smoking | Smoking | — | noyes |
Numeric Biomarkers
You can provide numeric biomarkers in any unit, not just the ones listed here.
Unit name will be normalized on our side. If that fails, value will be converted to one of our units. If we do not have your unit of choice, please reach out and we will add it.
| ID | NAME | LOINCs by priority | UNITS |
|---|---|---|---|
| age | Age | — | years |
| S-albumin | Albumin | 2862-1, 101198-0, 61152-5, 103577-3, 61151-7, 1751-7 | g/dLg/L |
| U-albumin | Albumin (urine) Urine Albumin (spot) | 14957-5, 53531-0, 89999-7, 1754-1, 6942-7, 11218-5 | mg/Lµg/mLmg/dL |
| alcoholIntake | Alcohol intake | — | units/week |
| S-ALP | ALP Alkaline Phosphatase | 6768-6 | IU/Lµkat/Lnkat/L |
| S-ALT | ALT Alanine Aminotransferase | 1743-4, 1742-6, 1744-2 | IU/Lµkat/Lnkat/L |
| S-ApoA1 | ApoA1 Apolipoprotein A-1 | 1869-7, 76483-7 | g/Lmg/dLµmol/L |
| S-ApoB | ApoB Apolipoprotein B | 1884-6, 76482-9 | mg/dLg/Lµmol/L |
| S-AST | AST Aspartate Aminotransferase | 30239-8, 1920-8 | IU/Lµkat/Lnkat/L |
| S-dBIL | Bilirubin (Direct) Direct Bilirubin | 1968-7, 14629-0 | mg/dLµmol/L |
| S-tBIL | Bilirubin (Total) Total Bilirubin | 1975-2, 14631-6 | mg/dLµmol/L |
| fatPercentage | Body fat Total body fat percentage auto-calculated if not provided | 41982-0, 77233-5 | % |
| S-BUN | BUN Serum Blood Urea Nitrogen (BUN) auto-calculated if not provided | 3094-0, 14937-7, 35234-4 | mg/dLmmol/L |
| S-C-peptide | C-peptide Fasting C-peptide | 1986-9, 13037-7, 14633-2, 42180-0 | ng/mLµg/Lnmol/Lpmol/L |
| S-cholesterol | Cholesterol (Total) | 2093-3, 14647-2 | mmol/Lmg/dL |
| S-creatinine | Creatinine | 103616-9, 2160-0, 14682-9, 35203-9 | µmol/Lmg/dLmg/L |
| U-creatinine | Creatinine (urine) Urine Creatinine (spot) | 2161-8, 14683-7, 30004-6 | mg/dLmmol/L |
| S-cystatin-C | Cystatin C | 33863-2 | mg/Lmg/dL |
| S-DHEAS | DHEAS DHEA Sulfate | 2191-5, 14688-6 | µmol/Lµg/dL |
| BP-dia | Diastolic Blood Pressure Diastolic blood pressure (seated) | 8462-4 | mmHg |
| S-estradiol | Estradiol | 35384-7, 72873-3, 2243-4, 14715-7, 83097-6, 83096-8 | pg/mLpmol/L |
| fatMass | Fat mass auto-calculated if not provided | — | kglb |
| S-ferritin | Ferritin | 2276-4, 14723-1, 35209-6, 20567-4 | µg/Lng/mLpmol/L |
| S-folate | Folate Folate - Vitamin B9 | 2284-8, 14732-2, 35210-4 | ng/mLµg/Lnmol/L |
| S-free-insulin | Free Insulin Serum Free Insulin | 6901-3, 43942-2, 25447-4 | µIU/mLmIU/Lpmol/Lµg/L |
| S-FSH | FSH Follicle stimulating hormone | 15067-2, 83098-4, 20433-9 | IU/LmIU/mL |
| S-fT3 | fT3 Free Triiodothyronine | 29239-1, 3051-0, 14928-6, 35230-2 | pg/mLng/Lpmol/L |
| S-fT4 | fT4 Free Thyroxine | 6892-4, 70217-5, 3024-7, 14920-3, 83122-2, 83121-4, 35228-6 | ng/dLpmol/L |
| S-GGT | GGT Gamma-glutamyl transferase | 2324-2 | IU/Lµkat/Lnkat/L |
| S-glucose | Glucose Fasting Glucose | 1558-6, 14771-0, 17865-7, 1554-5, 2345-7, 14749-6 | mg/dLmmol/L |
| gripStrength | Grip Strength (Maximal) | 83174-3, 83173-5 | kglb |
| B-HbA1c | HbA1c Blood Hemoglobin A1c | 4548-4, 27353-2, 53553-4 | %mmol/molmmol/Lmg/dL |
| HCT | HCT Hematocrit | 4544-3, 20570-8, 31100-1 | %L/L |
| S-HDL | HDL High-density lipoprotein cholesterol | 2085-9, 14646-4, 49130-8 | mg/dLmmol/L |
| height | Height | 8302-2, 3137-7, 3138-5 | cmmin |
| HGB | HGB Hemoglobin | 718-7, 59260-0, 20509-6, 55782-7 | g/dLg/Lmmol/L |
| S-holoTC | HoloTC Holotranscobalamin | 72160-5 | pmol/L |
| P-homocysteine | Homocysteine | 13965-9, 2428-1 | µmol/Lmg/dLmg/L |
| S-hsCRP | hsCRP High-Sensitivity C-Reactive Protein | 30522-7, 76486-0 | mg/Lµg/mL |
| S-insulin | Insulin Fasting Insulin | 27873-9, 59179-2, 30363-6, 1573-5, 20448-7, 14796-7, 3695-4 | µIU/mLmIU/Lpmol/Lµg/L |
| S-LDH | LDH Lactate dehydrogenase | 2532-0, 14805-6, 14804-9 | IU/Lµkat/L |
| S-LDL | LDL Low-density lipoprotein cholesterol | 18262-6, 69419-0, 49132-4, 55440-2, 2089-1, 22748-8, 35198-1, 13457-7, 39469-2 | mg/dLmmol/L |
| S-LH | LH Luteinizing hormone | 10501-5, 83103-2, 2579-1 | IU/LmIU/mL |
| S-lipase | Lipase | 3040-3 | IU/Lµkat/Lnkat/L |
| S-Lp-a | Lp(a) Lipoprotein(a) | 43583-4, 10835-7 | nmol/Lmg/dLg/L |
| LYM | LYM Lymphocytes % auto-calculated if not provided | 26478-8, 736-9, 737-7, 30365-1 | % |
| LYMabs | Lymphocytes (Absolute) Absolute lymphocyte count auto-calculated if not provided | 26474-7, 731-0, 732-8 | x10^9/Lx10^3/µLcells/µL |
| MCH | MCH Mean cell hemoglobin | 28539-5, 785-6, 59468-9 | pgfmol |
| MCHC | MCHC Mean corpuscular hemoglobin concentration | 28540-3, 59467-1, 786-4 | g/dLg/Lmmol/L |
| MCV | MCV Mean corpuscular volume | 787-2, 30428-7 | fL |
| P-MMA | MMA Methylmalonic Acid | 13964-2, 2629-4 | nmol/Lµmol/Lµg/dLµg/L |
| MONOabs | Monocytes (Absolute) Absolute monocyte count | 26484-6, 742-7, 743-5, 104548-3 | x10^9/Lx10^3/µLcells/µL |
| muscleMass | Muscle mass | — | kglb |
| NEUabs | Neutrophils (Absolute) Absolute neutrophil count | 26499-4, 751-8, 753-4 | x10^9/Lx10^3/µLcells/µL |
| S-pancr-amylase | Pancreatic Amylase | 1805-1 | IU/Lµkat/Lnkat/L |
| PLT | PLT Platelets | 26515-7, 777-3, 97995-5, 778-1, 49497-1 | x10^9/Lx10^3/µLcells/µL |
| S-prolactin | Prolactin Serum Prolactin | 15081-3, 83111-5, 2842-3, 20568-2 | ng/mLµg/LmIU/L |
| U-protein | Protein (urine) Urine Total Protein (spot) | 2888-6, 5804-0, 50561-0, 27298-9 | mg/dLg/dLg/L |
| RBC | RBC Red Blood Cell Count | 26453-1, 789-8, 790-6 | x10^12/Lx10^6/µLm/cumm |
| RDW | RDW Red blood cell distribution width | 30385-9, 788-0 | % |
| S-rT3 | rT3 Reverse Triiodothyronine (Total) | 3052-8, 14929-4 | ng/dLpg/mLpmol/L |
| S-SHBG | SHBG Sex hormone-binding globulin | 2942-1, 13967-5 | nmol/Lµg/dL |
| BP-sys | Systolic Blood Pressure Systolic blood pressure (seated) | 8480-6 | mmHg |
| fTST | Testosterone (Free) Calculated Free Testosterone (Vermeulen) auto-calculated if not provided | — | pg/mLng/dLpmol/L |
| S-TST | Testosterone (Total) Testosterone | 105121-8, 49041-7, 70239-9, 2986-8, 14913-8, 35224-5, 83116-4, 83115-6 | ng/dLng/mLnmol/L |
| S-TgAb-Roche | TgAb Thyroglobulin (Tg) Antibodies (Roche) | — | IU/mLkIU/L |
| S-TPOAb | TPOAb Thyroid Peroxidase (TPO) Antibodies | 8099-4, 56477-3 | IU/mLkIU/L |
| S-tPSA | tPSA Total Prostate-Specific Antigen | 35741-8, 83112-3, 2857-1 | ng/mLµg/L |
| S-TRAb | TRAb Thyrotropin Receptor (TSH) Antibodies | 5385-0, 57416-0 | IU/L |
| TSAT | Transferrin Saturation | 2502-3, 14801-5 | % |
| S-TAG | Triglycerides Triacylglycerols | 2571-8, 14927-8, 3048-6, 47210-0, 1644-4, 30524-3 | mg/dLmmol/L |
| S-TSH | TSH Thyroid Stimulating Hormone | 11580-8, 11579-0, 3016-3 | µIU/mLmIU/L |
| S-urea | Urea Serum Urea auto-calculated if not provided | 3091-6, 22664-7, 42571-0 | mmol/Lmg/dL |
| S-uric-acid | Uric acid | 3084-1, 14933-6, 35232-8 | mg/dLµmol/L |
| S-B12 | Vitamin B12 | 2132-9, 14685-2 | pg/mLng/Lpmol/L |
| S-25-OH-D | Vitamin D - 25(OH)D Total 25-Hydroxyvitamin D (D2 + D3) | 62292-8, 68438-1, 83070-3, 83071-1, 35365-6 | ng/mLµg/Lnmol/L |
| waistCirc | Waist circumference Waist circumference (WHO method) | 56115-9, 56114-2 | cmin |
| WBC | WBC White Blood Cells Count | 26464-8, 6690-2, 804-5, 49498-9 | x10^9/Lx10^3/µLcells/µL |
| weight | Weight | 29463-7, 3141-9, 3142-7 | kglb |