WHOOP как
источник данных
Полное руководство для исследователей — от понимания архитектуры до работающего pipeline
Устройство без экрана. Закрытая data-платформа. Один из самых точных носимых трекеров для HRV и сна. Здесь — всё, что нужно знать перед тем, как начать работать с физиологическими данными.
Не трекер.
Data-платформа.
WHOOP — носимый биометрический трекер без экрана, созданный исключительно для непрерывного мониторинга физиологии. В отличие от умных часов, у него нет уведомлений, шагомера или дисплея. Устройство делает одно, но делает это лучше большинства конкурентов: 24 часа в сутки, 7 дней в неделю измеряет три ключевых показателя.
Для исследователя ключевое понимание: сенсор собирает сырые PPG-сигналы, температуру, акселерометрию — но наружу отдаёт уже обработанные агрегаты. Raw data недоступны. Это не баг — это фундаментальное архитектурное решение платформы.
HRV (RMSSD), ЧСС покоя, SpO₂, температура кожи. Рассчитывается утром после сна.
Логарифмическая шкала 0–21. Физический и ментальный стресс за биологический цикл. Не аддитивна.
Стадии сна, латентность, эффективность, нарушения. Базовая единица — биологический цикл, не сутки.
Beat-to-beat интервалы (RR), сырые PPG-сигналы и данные акселерометра существуют на уровне сенсора, но платформа их не отдаёт ни через API, ни через экспорт.
От гарвардского стартапа
до инструмента NASA
Уилл Ахмед, студент Гарварда. Идея из личного разочарования: тренировался усердно, но не понимал, восстанавливается ли тело. Стандартные трекеры считали шаги — его интересовала физиология.
Тестирование с профессиональными спортсменами. Начало сотрудничества с командами НБА, НФЛ, NCAA. Главная идея: не «сколько ты сделал», а «насколько ты готов».
Первая массовая версия. Появляется алгоритм Strain — логарифмическая шкала, учитывающая не только тренировки, но и фоновый стресс.
Переход на подписочную модель. WHOOP становится стандартом в профессиональном спорте. НБА, НХЛ, UFC.
WHOOP публикует данные: изменения HRV и частоты дыхания фиксируются за 2–3 дня до появления симптомов COVID. Медицинские исследователи начинают работать с платформой.
SpO₂, температура кожи, детектор стресса. Оценка компании достигает $3,6 млрд. Инвесторы — Tiger Global, SoftBank.
ЭКГ, мониторинг артериального давления, биологический возраст. Официальный вход в медицинский сегмент.
Где используют WHOOP
исследователи
Австралийский институт спорта (AIS) провёл валидацию, подтвердив точность HR 99,7% и HRV 99% при сравнении с ЭКГ-стандартом. Команды НБА, НФЛ, НХЛ, FIFA используют WHOOP для управления нагрузками.
USSOCOM тестировал WHOOP для мониторинга боеготовности спецназа. Задача — определять момент, когда оперативник физически не готов к выполнению задачи.
Агентство изучало применение для мониторинга астронавтов. Непрерывное отслеживание HRV как маркера адаптационного стресса в условиях невесомости.
JMIR (2024), Schyvens et al. (2025), Dial et al. (2025). Десятки публикаций по биомаркерам восстановления, детекции COVID, мониторингу студентов-атлетов NCAA.
Изменения HRV и частоты дыхания фиксируются за 2–3 дня до симптомов. Первый носимый трекер с верифицированной ранней детекцией вирусного заражения.
Goldman Sachs, McKinsey — программы для топ-менеджмента. Агрегированные данные для анализа уровня стресса и истощения в командах.
Что говорит наука.
Честно.
Точность 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 | ✗ Ненадёжно |
WHOOP измеряет HRV только в окне глубокого сна — не непрерывно. Recovery Score и Strain — проприетарные алгоритмы без открытой валидации. Для строгих исследований работайте с сырыми метриками (HRV, RHR, стадии сна), а не с составными баллами.
Что внутри.
Полная карта полей.
Перед тем как приступать к экспорту — важно понять, что именно вы будете получать и в какой структуре.
Официальный экспорт
через приложение
Самый простой путь. Вся история одним запросом. Рекомендован как первый шаг для любого исследователя.
WHOOP
App Settings
whoop.com
Export раз в 24 часа
→ ZIP 30 мин — 2 ч
Главная таблица. Каждая строка — один биологический цикл. HRV, ЧСС покоя, Recovery Score, Strain, калории, сон.
ОСНОВНАЯ · НАЧНИТЕ ЗДЕСЬДетализация каждого сна и дремоты. Стадии в минутах, эффективность, нарушения, латентность.
СОНВсе зафиксированные активности. Тип, пульсовые зоны, Strain, калории. Без Strength Trainer.
НАГРУЗКА · Без силовыхДневниковые метки: алкоголь, кофеин, стресс, медикаменты. Ценный источник для корреляционного анализа.
ПОВЕДЕНИЕ# Загрузка основной таблицы 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())
Whoop2CSV —
без кода, автоматически
Для тех, кому нужна автоматизация без программирования. Сервис работает через официальный OAuth WHOOP — read-only, пароль никуда не передаётся.
.com
with WHOOP OAuth редирект
доступ только чтение
период 7 / 30 / 90 дней
Google Sheets автовыгрузка еженед.
- Настраиваемая периодичность
- Прямая интеграция с Google Sheets
- Гибкий выбор полей
- Нет ожидания 24 часа
- Максимум 90 дней за один запрос
- Нет полной истории как в официальном экспорте
- Зависимость от стороннего сервиса
Официальный
WHOOP Developer API
Для исследователей, которым нужна автоматизация, долгосрочный мониторинг нескольких участников или интеграция в собственный аналитический pipeline.
.whoop.com Бесплатно
приложение + Redirect URI
+ Secret
scopes read:recovery
read:sleep…
Token
запросы
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) между последовательными запросами.
Python-библиотеки:
whoopy и whoop-data
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}")
Использует реверс-инжиниринг внутреннего 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" )
Интеграция
с Apple Health
Интеграции
→ Подключить
категории Разрешить
Приложения управление
разрешениями
HRV не передаётся между платформами — разные единицы: WHOOP использует RMSSD (мс), Apple Health — SDNN (мс). Синхронизация не мгновенная, работает в фоновом режиме. Для экспорта из Apple Health в произвольный формат используйте приложение Health Auto Export.
Автоматизированный
self-hosted пайплайн
Для долгосрочных исследований с несколькими участниками и необходимостью хранения данных в собственной инфраструктуре.
Self-hosted сервер на Docker. Ежедневно автоматически скачивает данные всех подключённых аккаунтов. Экспорт в AWS S3, локальный CSV/JSON. Для многопользовательских исследований.
Python-приложение с поддержкой PostgreSQL/SQLite, CSV/JSON/Excel, cron-синхронизации. Для персональной исследовательской базы данных.
Какой метод выбрать
| Метод | Сложность | Автоматизация | История | Детальность | Статус |
|---|---|---|---|---|---|
| Официальный экспорт (app) | ★☆☆☆☆ | Ручной | Вся | Агрегаты | ✓ Официально |
| Whoop2CSV | ★☆☆☆☆ | Google Sheets | 90 дней | Агрегаты | ✓ Официально |
| Официальный API | ★★★☆☆ | Да | Вся | Агрегаты | ✓ Официально |
| Python whoopy | ★★★☆☆ | Да (cron) | Вся | Агрегаты | ✓ Официально |
| Python whoop-data | ★★★☆☆ | Да | Вся | HR 6-сек | ⚠ Неофициально |
| Self-hosted pipeline | ★★★★★ | Да (сервер) | Вся | Агрегаты | ✓ Официально |
Начинающему исследователю: старт с официального экспорта через приложение. Через 10 минут у вас будет вся история в CSV. Дальше — whoopy для автоматизации.
Что делать с данными дальше
Откройте physiological_cycles.csv. Постройте три простых графика:
- HRV по времени — видны паттерны восстановления и стресса
- Зависимость Recovery Score от времени сна
- Strain текущего дня vs Recovery следующего утра
Загрузить все четыре CSV. Конвертировать временные метки в datetime с учётом часового пояса. Создать единую таблицу через merge по дате цикла.
- Автокорреляция HRV
- Детектирование аномалий через z-score
- Корреляционный анализ journal.csv с Recovery
Работать только с сырыми метриками: HRV (RMSSD), ЧСС покоя, стадии сна в минутах. Избегать Recovery Score и Strain как зависимых переменных — проприетарные алгоритмы без открытой валидации.
- Все временные метки — ISO UTC
- При синхронизации с ЭЭГ, опросниками или поведенческими данными — единый часовой пояс обязателен
Честные ограничения
WHOOP для науки
Укажите эти ограничения в методологическом разделе любой публикации, использующей данные WHOOP.
- Longitudinal мониторинга в реальных условиях
- Поведенческих исследований (недели, месяцы)
- Паттернов восстановления на больших горизонтах
- Когортных исследований (несколько участников)
- Коучинга и прикладных программ
- Детекции COVID-паттернов
- Исследований, требующих beat-to-beat HRV
- Точной стадийности сна (особенно REM и пробуждения)
- Кастомной аналитики физиологических сигналов
- Интрадневного непрерывного HRV
- Лабораторных условий с высокой точностью
- Исследований с высокоинтенсивными нагрузками
Для задач, требующих beat-to-beat HRV или сырых сигналов — рассмотрите Oura Ring (более открытый API, CCC = 0.99) или специализированное оборудование (Polar H10 + Elite HRV, Zephyr BioHarness).