Skip to content
Browse documentation
Work with data / ATH documentation

Read the detail.

An overview when you need orientation. Individual samples when you need evidence.

Start with the overview

See the available measurements, date coverage, per-source averages and benchmark history. Coverage matters as much as the number itself.

$ath stats

Inspect a measurement

A series prints one summary row per day. Filter a date range, select one source, or use --raw for individual samples.

$ath series heart_rate
$ath series heart_rate --from 2026-08-24 --to 2026-08-30
$ath series heart_rate --source apple-watch-1 --raw

Pass it to an agent

Use --json for structured output. Use the actual source IDs shown by ath stats; the source above is an example.

$ath stats --json
$ath series heart_rate --json