// Исследовательский гайд · 2025

WHOOP как
источник данных

Полное руководство для исследователей — от понимания архитектуры до работающего pipeline

Устройство без экрана. Закрытая data-платформа. Один из самых точных носимых трекеров для HRV и сна. Здесь — всё, что нужно знать перед тем, как начать работать с физиологическими данными.

Recovery
Strain
Sleep
0 % точность HR (AIS, 2022)
0 % точность HRV ночью
0 способов получить данные
// 01 · Архитектура

Не трекер.
Data-платформа.

WHOOP — носимый биометрический трекер без экрана, созданный исключительно для непрерывного мониторинга физиологии. В отличие от умных часов, у него нет уведомлений, шагомера или дисплея. Устройство делает одно, но делает это лучше большинства конкурентов: 24 часа в сутки, 7 дней в неделю измеряет три ключевых показателя.

Для исследователя ключевое понимание: сенсор собирает сырые PPG-сигналы, температуру, акселерометрию — но наружу отдаёт уже обработанные агрегаты. Raw data недоступны. Это не баг — это фундаментальное архитектурное решение платформы.

Сенсор
PPG Температура кожи Акселерометр
🔒 Backend Algorithms
Proprietary algorithm
Закрытая логика обработки — raw data не передаётся
Вы получаете
HRV (RMSSD) Recovery Score Sleep Stages Strain Score
Recovery

HRV (RMSSD), ЧСС покоя, SpO₂, температура кожи. Рассчитывается утром после сна.

Strain

Логарифмическая шкала 0–21. Физический и ментальный стресс за биологический цикл. Не аддитивна.

Sleep

Стадии сна, латентность, эффективность, нарушения. Базовая единица — биологический цикл, не сутки.

Beat-to-beat интервалы (RR), сырые PPG-сигналы и данные акселерометра существуют на уровне сенсора, но платформа их не отдаёт ни через API, ни через экспорт.

// 02 · История

От гарвардского стартапа
до инструмента NASA

2012
Основание

Уилл Ахмед, студент Гарварда. Идея из личного разочарования: тренировался усердно, но не понимал, восстанавливается ли тело. Стандартные трекеры считали шаги — его интересовала физиология.

2014–2015
Первые партнёрства

Тестирование с профессиональными спортсменами. Начало сотрудничества с командами НБА, НФЛ, NCAA. Главная идея: не «сколько ты сделал», а «насколько ты готов».

2016
WHOOP 2.0

Первая массовая версия. Появляется алгоритм Strain — логарифмическая шкала, учитывающая не только тренировки, но и фоновый стресс.

2018
WHOOP 3.0 + подписка

Переход на подписочную модель. WHOOP становится стандартом в профессиональном спорте. НБА, НХЛ, UFC.

2020–2021
COVID-исследование

WHOOP публикует данные: изменения HRV и частоты дыхания фиксируются за 2–3 дня до появления симптомов COVID. Медицинские исследователи начинают работать с платформой.

2021
WHOOP 4.0 · $3.6B

SpO₂, температура кожи, детектор стресса. Оценка компании достигает $3,6 млрд. Инвесторы — Tiger Global, SoftBank.

2024–2025
WHOOP 5.0 MG

ЭКГ, мониторинг артериального давления, биологический возраст. Официальный вход в медицинский сегмент.

// 03 · Научная валидация

Где используют WHOOP
исследователи

🏋️
Спортивная наука

Австралийский институт спорта (AIS) провёл валидацию, подтвердив точность HR 99,7% и HRV 99% при сравнении с ЭКГ-стандартом. Команды НБА, НФЛ, НХЛ, FIFA используют WHOOP для управления нагрузками.

🎖️
Военная медицина

USSOCOM тестировал WHOOP для мониторинга боеготовности спецназа. Задача — определять момент, когда оперативник физически не готов к выполнению задачи.

🚀
NASA

Агентство изучало применение для мониторинга астронавтов. Непрерывное отслеживание HRV как маркера адаптационного стресса в условиях невесомости.

🎓
Университетские лаборатории

JMIR (2024), Schyvens et al. (2025), Dial et al. (2025). Десятки публикаций по биомаркерам восстановления, детекции COVID, мониторингу студентов-атлетов NCAA.

🦠
COVID-исследования

Изменения HRV и частоты дыхания фиксируются за 2–3 дня до симптомов. Первый носимый трекер с верифицированной ранней детекцией вирусного заражения.

🏢
Корпоративный wellbeing

Goldman Sachs, McKinsey — программы для топ-менеджмента. Агрегированные данные для анализа уровня стресса и истощения в командах.

// 04 · Точность

Что говорит наука.
Честно.

Точность WHOOP неоднородна в зависимости от метрики. Для исследователя важно понимать, где данные надёжны, а где — нет.

Метрика Точность Источник Статус
Пульс (покой/сон)99.7%AIS, 2022✓ Надёжно
HRV RMSSD (ночной)99%AIS, 2022✓ Надёжно
Общее время сна−1.4 мин смещениеJMIR, 2024✓ Надёжно
Глубокий сон−9.3 мин, чувств. 69.6%Schyvens, 2025~ Приемлемо
REM-сон+21.0 мин переоценкаJMIR, 2024⚠ Осторожно
Пробужденияспецифичность 51%Schyvens, 2025✗ Слабое место
HR на тренировкеотставание до 50 уд/минCommunity✗ Ненадёжно
Сравнение точности HRV по трекерам (Dial et al., 2025)
Oura Gen 4
CCC 0.99
Oura Gen 3
CCC 0.97
WHOOP 4.0
CCC 0.94
Garmin Fenix 6
CCC 0.87
Polar Grit X Pro
CCC 0.82
// ВАЖНО

WHOOP измеряет HRV только в окне глубокого сна — не непрерывно. Recovery Score и Strain — проприетарные алгоритмы без открытой валидации. Для строгих исследований работайте с сырыми метриками (HRV, RHR, стадии сна), а не с составными баллами.

// 05 · Архитектура данных

Что внутри.
Полная карта полей.

Перед тем как приступать к экспорту — важно понять, что именно вы будете получать и в какой структуре.

Recovery — утренний расчёт
hrv_rmssd_milliHRV в миллисекундах · Используйте это, а не score
resting_heart_rateЧСС покоя (уд/мин)
recovery_score0–100 · ⚠ Проприетарный алгоритм
spo2_percentageНасыщение кислородом (%)
skin_temp_celsiusДельта температуры от базовой линии
Sleep
total_in_bed_timeОбщее время в постели (мин)
total_sleep_timeРеальное время сна (мин)
sleep_efficiencyЭффективность (%)
slow_wave_sleepГлубокий сон (мин) · смещение −9.3 мин
rem_sleepREM (мин) · переоценка +21 мин
sleep_latencyЛатентность засыпания (мин)
disturbancesКоличество нарушений · низкая специфичность
Cycle — биологический цикл
strainНагрузка 0–21 · ⚠ Логарифмическая, непрямая
kilojouleЭнергозатраты (кДж)
average_heart_rateСредний пульс за цикл
cycle_start / endISO 8601, UTC
Workout
sport_nameТип активности
durationПродолжительность (сек)
avg / max_heart_rateПульс средний и максимальный
zone_1–5_minutesМинуты в каждой пульсовой зоне
strainНагрузка активности (0–21)
// 06 · Экспорт данных · Метод 1

Официальный экспорт
через приложение

★★☆☆☆ Сложность: минимальная Вся история Без кода Ручной

Самый простой путь. Вся история одним запросом. Рекомендован как первый шаг для любого исследователя.

01
Приложение
WHOOP
02
More →
App Settings
03
Data Export или account.
whoop.com
04
Request
Export
раз в 24 часа
05
Email
→ ZIP
30 мин — 2 ч
06
4 × CSV вся история
physiological_cycles.csv

Главная таблица. Каждая строка — один биологический цикл. HRV, ЧСС покоя, Recovery Score, Strain, калории, сон.

ОСНОВНАЯ · НАЧНИТЕ ЗДЕСЬ
sleeps.csv

Детализация каждого сна и дремоты. Стадии в минутах, эффективность, нарушения, латентность.

СОН
workouts.csv

Все зафиксированные активности. Тип, пульсовые зоны, Strain, калории. Без Strength Trainer.

НАГРУЗКА · Без силовых
journal_entries.csv

Дневниковые метки: алкоголь, кофеин, стресс, медикаменты. Ценный источник для корреляционного анализа.

ПОВЕДЕНИЕ
# Загрузка основной таблицы
import pandas as pd

cycles = pd.read_csv('physiological_cycles.csv')

# Конвертация временных меток в UTC
cycles['cycle_start'] = pd.to_datetime(
    cycles['cycle_start'], utc=True
)

# Конвертация в локальный часовой пояс
cycles['cycle_start'] = cycles['cycle_start'].dt.tz_convert(
    'Europe/Moscow'
)

print(cycles[['cycle_start', 'hrv_rmssd_milli',
              'resting_heart_rate', 'recovery_score']].head())
// 06 · Экспорт данных · Метод 2

Whoop2CSV —
без кода, автоматически

★☆☆☆☆ Сложность: минимальная До 90 дней OAuth Google Sheets

Для тех, кому нужна автоматизация без программирования. Сервис работает через официальный OAuth WHOOP — read-only, пароль никуда не передаётся.

01
whoop2csv
.com
02
Connect
with WHOOP
OAuth редирект
03
Разрешить
доступ
только чтение
04
Выбрать
период
7 / 30 / 90 дней
05
CSV или
Google Sheets
автовыгрузка еженед.
Преимущества перед app-экспортом
  • Настраиваемая периодичность
  • Прямая интеграция с Google Sheets
  • Гибкий выбор полей
  • Нет ожидания 24 часа
Ограничения
  • Максимум 90 дней за один запрос
  • Нет полной истории как в официальном экспорте
  • Зависимость от стороннего сервиса
// 06 · Экспорт данных · Метод 3

Официальный
WHOOP Developer API

★★★☆☆ Сложность: средняя OAuth 2.0 Автоматизация Мультиюзер

Для исследователей, которым нужна автоматизация, долгосрочный мониторинг нескольких участников или интеграция в собственный аналитический pipeline.

01
developer
.whoop.com
Бесплатно
02
Создать
приложение
+ Redirect URI
03
Client ID
+ Secret
04
Выбрать
scopes
read:recovery
read:sleep…
05
Access
Token
06
API
запросы
GET/v2/recoveryRecovery Score, HRV, RHR, SpO₂, температура
GET/v2/activity/sleepСтадии сна, эффективность, нарушения
GET/v2/activity/workoutТренировки, пульсовые зоны, Strain
GET/v2/cycleФизиологические циклы, общая нагрузка
GET/v2/user/profile/basicПрофиль пользователя
import requests

access_token = "ВАШ_ТОКЕН"

def get_all_recovery(start_date: str) -> list:
    """Получить всю историю Recovery с пагинацией"""
    url = "https://api.prod.whoop.com/developer/v2/recovery"
    headers = {"Authorization": f"Bearer {access_token}"}
    results = []
    params = {"limit": 25, "start": start_date}

    while True:
        response = requests.get(url, headers=headers, params=params)
        data = response.json()
        results.extend(data["records"])

        # Пагинация через next_token
        if not data.get("next_token"):
            break
        params["next_token"] = data["next_token"]

    return results

history = get_all_recovery("2023-01-01T00:00:00Z")
print(f"Получено записей: {len(history)}")

Rate limit — около 1000 запросов/час. При мультипользовательских исследованиях (>10 участников) запросите увеличение лимита: support@developer.whoop.com. Добавляйте time.sleep(1) между последовательными запросами.

// 06 · Экспорт данных · Метод 4

Python-библиотеки:
whoopy и whoop-data

★★★☆☆ Сложность: средняя Pandas DataFrame Автопагинация
install pip install whoopy
Автоматически обрабатывает пагинацию next_token
Возвращает данные как pandas DataFrame
Поддерживает async-режим
Token refresh из коробки
from whoopy import WhoopClient

client = WhoopClient(client_id="...", client_secret="...")

# Вся история сна как DataFrame
sleep_df = client.sleep.get_dataframe(
    start="2023-01-01",
    end="2025-03-01"
)

# Корреляция HRV и глубокого сна
correlation = sleep_df['hrv_rmssd_milli'].corr(
    sleep_df['slow_wave_duration']
)
print(f"Корреляция HRV и глубокого сна: {correlation:.3f}")
install pip install whoop-data
HR с гранулярностью 6 секунд — недоступно в официальном API
HR с гранулярностью 1 минута
Авторизация по логину/паролю (не OAuth)

Использует реверс-инжиниринг внутреннего API WHOOP. Нарушает Terms of Service. Может измениться без предупреждения. Теоретически — риск блокировки аккаунта. Используйте осознанно.

from whoop_data import WhoopClient

client = WhoopClient(
    username="email@example.com",
    password="пароль"
)

# HR каждые 6 секунд за неделю
hr_raw = client.get_heart_rate(
    from_date="2024-01-01",
    to_date="2024-01-07",
    frequency="6"  # "6", "60" или "600"
)
// 06 · Экспорт данных · Метод 5

Интеграция
с Apple Health

★☆☆☆☆ Сложность: минимальная iOS only Двусторонняя синхронизация
01
WHOOP →
Интеграции
02
Apple Health
→ Подключить
03
Выбрать
категории
Разрешить
04
Health →
Приложения
управление
разрешениями
Из WHOOP → Apple Health
Сон (стадии, эффективность)
ЧСС покоя
Средний пульс
SpO₂
Частота дыхания
Тренировки (Strain, калории)
Recovery Score
Из Apple Health → WHOOP
Активности (тренировки)
Шаги (ограничено в WHOOP 5.0)
HR из других устройств
// NOTE

HRV не передаётся между платформами — разные единицы: WHOOP использует RMSSD (мс), Apple Health — SDNN (мс). Синхронизация не мгновенная, работает в фоновом режиме. Для экспорта из Apple Health в произвольный формат используйте приложение Health Auto Export.

// 06 · Экспорт данных · Метод 6

Автоматизированный
self-hosted пайплайн

★★★★★ Сложность: высокая Мультиюзер Docker PostgreSQL Grafana

Для долгосрочных исследований с несколькими участниками и необходимостью хранения данных в собственной инфраструктуре.

WHOOP API Python Scheduler PostgreSQL Grafana Dashboard App Export CSV pandas
MyWhoop
github.com/karl-cardenas-coding/mywhoop

Self-hosted сервер на Docker. Ежедневно автоматически скачивает данные всех подключённых аккаунтов. Экспорт в AWS S3, локальный CSV/JSON. Для многопользовательских исследований.

Get-My-Whoop
github.com/zachgodsell93/Get-My-Whoop

Python-приложение с поддержкой PostgreSQL/SQLite, CSV/JSON/Excel, cron-синхронизации. Для персональной исследовательской базы данных.

Рекомендуемый production-стек
01Сбор данныхWHOOP API + whoopy
02ОбработкаPython + pandas
03ХранениеPostgreSQL
04ВизуализацияGrafana
Покрывает большинство исследовательских задач, работает в реальном времени, масштабируется на несколько участников.
// Итоговая таблица

Какой метод выбрать

Метод Сложность Автоматизация История Детальность Статус
Официальный экспорт (app) ☆☆☆☆ Ручной Вся Агрегаты ✓ Официально
Whoop2CSV ☆☆☆☆ Google Sheets 90 дней Агрегаты ✓ Официально
Официальный API ★★★☆☆ Да Вся Агрегаты ✓ Официально
Python whoopy ★★★☆☆ Да (cron) Вся Агрегаты ✓ Официально
Python whoop-data ★★★☆☆ Да Вся HR 6-сек ⚠ Неофициально
Self-hosted pipeline ★★★★★ Да (сервер) Вся Агрегаты ✓ Официально

Начинающему исследователю: старт с официального экспорта через приложение. Через 10 минут у вас будет вся история в CSV. Дальше — whoopy для автоматизации.

// 07 · Аналитика

Что делать с данными дальше

Уровень 1 Начинающий Google Sheets / Excel

Откройте physiological_cycles.csv. Постройте три простых графика:

  • HRV по времени — видны паттерны восстановления и стресса
  • Зависимость Recovery Score от времени сна
  • Strain текущего дня vs Recovery следующего утра
Уровень 2 Аналитик Python + pandas

Загрузить все четыре CSV. Конвертировать временные метки в datetime с учётом часового пояса. Создать единую таблицу через merge по дате цикла.

  • Автокорреляция HRV
  • Детектирование аномалий через z-score
  • Корреляционный анализ journal.csv с Recovery
Уровень 3 Исследователь Публикации

Работать только с сырыми метриками: HRV (RMSSD), ЧСС покоя, стадии сна в минутах. Избегать Recovery Score и Strain как зависимых переменных — проприетарные алгоритмы без открытой валидации.

  • Все временные метки — ISO UTC
  • При синхронизации с ЭЭГ, опросниками или поведенческими данными — единый часовой пояс обязателен
// 08 · Методологические ограничения

Честные ограничения
WHOOP для науки

Укажите эти ограничения в методологическом разделе любой публикации, использующей данные WHOOP.

WHOOP подходит для
  • Longitudinal мониторинга в реальных условиях
  • Поведенческих исследований (недели, месяцы)
  • Паттернов восстановления на больших горизонтах
  • Когортных исследований (несколько участников)
  • Коучинга и прикладных программ
  • Детекции COVID-паттернов
WHOOP не подходит для
  • Исследований, требующих beat-to-beat HRV
  • Точной стадийности сна (особенно REM и пробуждения)
  • Кастомной аналитики физиологических сигналов
  • Интрадневного непрерывного HRV
  • Лабораторных условий с высокой точностью
  • Исследований с высокоинтенсивными нагрузками

Для задач, требующих beat-to-beat HRV или сырых сигналов — рассмотрите Oura Ring (более открытый API, CCC = 0.99) или специализированное оборудование (Polar H10 + Elite HRV, Zephyr BioHarness).