Skip to content

SweatStack developer docs

SweatStack is the sports data platform for developers. One API for activity, daily, and test data across every supported wearable. Build personal automations, public products, or the next coaching platform without scraping or shimming wearable APIs yourself.

Get started API reference

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

  • API reference & playground

    Every endpoint and response schema, generated from the OpenAPI spec. Plus the live playground for running requests with your logged-in account.

    API reference · Playground

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

  • Applications

    Register your app, manage credentials, configure redirect URIs and webhooks, and pick your publishing path.

    Applications

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

SweatStack architecture diagram showing how devices connect to apps through the SweatStack platform

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.