Skip to main content

ECG Advanced API

The Advanced tier builds on Basic analysis and provides additional capabilities such as heart rate variability (HRV), heart age assessment, mental/emotional evaluation, and micro health check (DeepLife).

Subscription requirement

The ECG Advanced API requires an Advanced subscription. View pricing

Signal quality guidance

All analysis endpoints return sqGrade to indicate signal quality. It is recommended to use results when sqGrade >= 0.7. See details →

Full ECG analysis​

POST /api/v1/advanced/ecg/analyze​

Performs full ECG analysis, including all Basic-tier analysis results plus advanced metrics such as heart age, respiratory rate, HRV, pressure/emotion indices, disease risk mapping, and more.

Request parameters​

ParameterTypeRequiredDescription
ecgDataarray✅ECG signal data array (ADC values)
ecgSampleRatenumber✅Sampling rate (Hz, recommended 250–500)
adcGainnumber❌Gain coefficient (default 1.0)
adcZeronumber❌Zero/baseline voltage (default 0.0)

Response (high-level)​

In addition to Basic response fields, the Advanced response includes:

  • Heart age (heartAge)
  • Respiratory rate (respiratoryRate)
  • HRV (hrv)
  • Pressure index (pressure)
  • Emotion index (emotion)
  • Fatigue index (fatigue)
  • Vitality index (vitality)
  • Risk mapping (riskMapping)
Diagnosis label note

The diagnosis and possibleDiags fields return diagnosis label codes. Convert them using the diagnosis label reference table below.

Heart age assessment​

POST /api/v1/advanced/ecg/heart-age​

Evaluate heart age based on ECG signals and HRV indicators.

Request parameters (same as Full ECG analysis)​

  • ecgData
  • ecgSampleRate
  • adcGain (optional)
  • adcZero (optional)

The response provides:

  • Heart age value
  • Signal quality rating

Mental/emotional state assessment​

POST /api/v1/advanced/ecg/mental-state​

Assess mental/emotional state (pressure/emotion) and fatigue/vitality indicators based on ECG features.

The response provides:

  • Pressure index and emotion index
  • Fatigue index and vitality index

DeepLife micro health check​

POST /api/v1/advanced/ecg/deepLife​

DeepLife displays core information for 11 common infectious diseases and the model’s recognition performance for them.

It includes:

  • ICD coding for standardized disease identification
  • Positive/negative sample counts (confirmed vs non-confirmed)
  • AUC value (recognition quality, 0–1)

For detailed reference data: download the material linked in the original documentation.

Diagnosis label reference table​

For single-lead diagnosis label code meanings, please refer to the ECG Basic API label mapping table:

Next steps​