PPG Basic API
Coming soon
The PPG analysis endpoint is under development. Please stay tuned. If you have requirements, contact us to apply for the beta testing program.
The PPG (photoplethysmography pulse wave) analysis API provides health metrics such as heart rate and blood oxygen (SpO2) based on wearable devices like smart watches and wristbands.
Feature preview
Features to be supported
| Feature | Description | Status |
|---|---|---|
| Heart rate detection | Accurate heart rate calculation based on PPG signals | 🔜 In development |
| SpO2 estimation | Estimation of blood oxygen saturation | 🔜 In development |
| Signal quality | PPG signal quality assessment | 🔜 In development |
| Respiration rate | Respiration rate estimation based on PPG | 📋 Planning |
Planned endpoints
POST /api/v1/basic/ppg/analyze
Planned basic PPG signal analysis.
Planned parameters
| Parameter | Type | Description |
|---|---|---|
| data | array | PPG signal data (red / infrared / green) |
| sampling_rate | number | Sampling rate (typically 25–100Hz) |
| signal_type | string | Signal type: red / ir / green |
| led_current | number | LED current (optional) |
Expected response
{
"status": "success",
"data": {
"heart_rate": {
"value": 72,
"confidence": 0.92
},
"spo2": {
"value": 98,
"confidence": 0.88
},
"signal_quality": {
"score": 0.85,
"level": "good"
},
"respiratory_rate": {
"value": 16,
"confidence": 0.75
}
}
}
Use cases
- Smart watch: real-time heart rate and SpO2 monitoring
- Exercise band: tracking exercise heart rate
- Health monitoring: daily health data collection
- Sleep monitoring: nighttime physiological metric monitoring
Data requirements
Signal type
| Type | Wavelength | Use case |
|---|---|---|
| Green (green) | 520–530nm | Heart rate detection (for exercise scenarios) |
| Red (red) | 640–660nm | SpO2 estimation |
| Infrared (ir) | 880–940nm | SpO2 estimation |
Sampling requirements
- Sampling rate: recommended 25Hz or higher, best at 50–100Hz
- Duration: recommended at least 10 seconds
- Precision: recommend 12-bit or higher ADC
Apply for beta access
If you are interested in PPG analysis, please contact us to apply for beta access:
- 📧 Email: contact@heartvoice.com.cn
- 💬 Topic: PPG API beta application
We will notify you as soon as the feature is released.
Related documentation
- ECG Basic API - ECG signal analysis (available)
- ECG Advanced API - ECG advanced features (available)
- PPG Advanced API - PPG advanced features (coming soon)