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 integrating each wearable's API yourself.

Get started API reference

Build

  • 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. One attribute per API resource: client.activities.list(), client.tests.retrieve(...).

    Python SDK · Reference

  • CLI

    Manage applications and deploy to SweatStack Pages from the terminal.

    CLI

  • Frameworks

    Sign-in helpers for FastAPI and Streamlit: OAuth, sessions, and a client per signed-in user.

    Frameworks

  • SweatStack Pages

    Host a static frontend for your application without running infrastructure. Deploy with the CLI or the 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

  • Sign in with SweatStack

    One button replaces your login and registration. Users authenticate with the wearable account they already have, and the account arrives with their profile and data.

    Sign in with SweatStack

  • 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. The same shape, whatever the 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 intensity-duration models, derived from the athlete's training data.

    Metabolic profile

  • App metadata

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

    App metadata

  • Webhooks

    Get notified 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 examples: 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.