Skip to content

SweatStack developer docs

This is the developer documentation for SweatStack, the sports data platform: sign-in and consent, athletes' activities and health data, the analysis on top, and the SDKs and tools to build with.

Get started API reference

Build

  • 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

  • AI coding

    Skills for AI coding agents, the OpenAPI schema and prompting tips, so your agent writes code against the real API.

    AI coding

  • Sign in with SweatStack

    One button replaces your login and registration. Athletes sign in with the account their watch already syncs to, 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

  • Scopes and consent

    Your app requests data categories. The athlete sees one line per category, with your reason, and can withdraw access at any time.

    Scopes

  • How athletes connect

    Hosted, bring your own keys or bring your own data. Your code reads every athlete the same way, and the price is the same.

    Choosing how athletes connect

  • 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 activities.

    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

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.