Stacking Sats Logo

Stacking Sats is an open source initiative for building, backtesting, and deploying optimal Bitcoin accumulation strategies for both retail and institutional investors.

Quick Links

AboutDocumentation

Connect

DiscordDiscordXX (Twitter)LinkedInLinkedInGitHubGitHub
© 2024 Stacking Sats. All rights reserved.
PrivacyPrivacy Policy•TermsTerms of Service
Stacking Sats
BetaWe're currently optimizing the experience
Stacking Sats Docs
Stacking Sats Docs
IntroductionQuick Start
OverviewSignal InterpretationAccumulation StrategiesAssumptions and Limitations
OverviewWeight ComputationFeature ConstructionSignal CompositionDynamic MultiplierModel Constants
OverviewPerformance ResultsSPD CalculationModel ScoreValidation Checks
OverviewAgent APIAgent builder guideGlossaryBitcoin
OverviewContributing
Python Package

Python Package

Overview

Start here if you want the shortest explanation of what the StackSats package does and how it relates to the Stacking Sats app and research workflow.

Last reviewed
March 10, 2026
Audience
Python users and contributors
Format
Overview
Read time
4 min

stacksats is Hypertrial's strategy-first Python package for Bitcoin DCA research and execution.

Package overview

Use StackSats when you want strategy research outside the app UI

The package gives you a strategy lifecycle for reproducible backtests, allocation mechanics, and exported artifacts that fit downstream research or operational workflows.

Open contribution guideOpen hosted package docs

What It Does

  • Define strategy intent while the framework handles allocation mechanics.
  • Validate and backtest strategies with reproducible outputs.
  • Export strategy artifacts for downstream analysis and operations.

Stacking Sats web app: This Python package is separate from live trading in the app. For the new user flow (profile → plan → personal API token → Agent API), see Quick Start.

Quick Start

pip install stacksats
stacksats strategy backtest \
  --strategy stacksats.strategies.examples:SimpleZScoreStrategy \
  --start-date 2024-01-01 \
  --end-date 2024-12-31 \
  --output-dir output

Canonical Documentation

Reference

Hosted package docs

Use the standalone StackSats documentation site for the full Python package API and workflow surface.

Open hosted docs→

Source

GitHub repository

Open the repository when you need implementation detail, issue history, or contribution context.

Open repository→

Distribution

PyPI package

Use the package index entry for installation metadata, versions, and release distribution.

Open PyPI→

Prerequisites

  • Python 3.10+ environment.
  • Basic comfort with CLI execution.

Next Step

Contributing

Related Pages

  • Documentation Hub
  • Weight Computation
  • Backtest Overview

Bitcoin

Curated Bitcoin learning resources, dashboards, and research references.

Contributing

How to contribute to the StackSats Python package and where to find the canonical contribution workflow.

On this page

What It DoesQuick StartCanonical Documentation
Stacking Sats Logo

Stacking Sats is an open source initiative for building, backtesting, and deploying optimal Bitcoin accumulation strategies for both retail and institutional investors.

Quick Links

AboutDocumentation

Connect

DiscordDiscordXX (Twitter)LinkedInLinkedInGitHubGitHub
© 2024 Stacking Sats. All rights reserved.
PrivacyPrivacy Policy•TermsTerms of Service