SweatStack developer docs

SweatStack is the sports data platform for developers. One API for activity, daily, and test data across every supported wearable. These docs cover everything you need to build on it: the API, the official Python client, the CLI, OAuth2 flows, and integrations with FastAPI, Streamlit, and Jupyter.

Get started in 5 minutes Browse the API

---

Build with

• AI coding

  ---

  Installable skills for AI agents, OpenAPI schema, prompting tips. The fastest way to ship working SweatStack code.

  AI coding

• Python SDK

  ---

  The official client. Full coverage of the API, with class-based and module-level interfaces.

  Python SDK · Reference

• CLI

  ---

  Manage applications and deploy to SweatStack Pages from the terminal.

  CLI

• Frameworks

  ---

  Drop-in helpers for FastAPI, Streamlit, and Jupyter. Auth, session handling, and notebook integration.

  Frameworks

• SweatStack Pages

  ---

  Host a static frontend for your application without standing up infrastructure. Deploy via the CLI or HTTP API.

  SweatStack Pages

• Interactive API docs

  ---

  Live OpenAPI UI for every endpoint. Test calls directly in your browser.

  Open API docs

---

Identity & onboarding

• SweatStack Connect

  ---

  Drop-in onboarding. Users authenticate with their existing wearable account, no SweatStack signup required.

  SweatStack Connect

• OAuth2 / OpenID Connect

  ---

  Standards-compliant OAuth2, PKCE, and OIDC. JWTs signed with RS256, JWKS published. Works with any compliant client library.

  OAuth2 & OIDC

• Managing apps

  ---

  Register an OAuth2 application, configure redirect URIs, manage credentials.

  Managing apps

---

Data

• Activities

  ---

  Per-activity timeseries and longitudinal queries across years of history. Same shape regardless of source.

  Activities · Data model

• Dailies

  ---

  Body mass, resting heart rate, HRV, sleep. Date-keyed, one endpoint per measure.

  Dailies

• Tests

  ---

  Lactate, VO2max, and FTP tests with a defined results schema covering thresholds, capacity ceilings, and economy.

  Tests

• Metabolic profile

  ---

  Thresholds, training zones, and effort-duration models. Built from tests plus training data.

  Metabolic profile

• App metadata

  ---

  Attach per-app JSON to activities, traces, tests, and users. Skip running your own database.

  App metadata

• Webhooks

  ---

  Subscribe to real-time events when activities or tests are created, updated, or deleted. HMAC-SHA256 signed.

  Webhooks

---

How it fits together

---

Guides and changelog

• Guides

  ---

  Worked approaches: starter projects, native mobile architecture, onboarding UX, and analysis workflows.

  Guides

• Changelog

  ---

  What's new in the API and the SDK.

  Changelog

---

For pricing, the company, and editorial content, see sweatstack.no.