Skip to content

StackSats Documentation

Strategy-first Bitcoin DCA toolkit

Build, validate, and backtest stacking sats strategies with a sealed allocation framework.

StackSats, developed by Hypertrial, is a Python package for strategy-first Bitcoin DCA ("stacking sats") research and execution. Learn more at www.stackingsats.org.

  • Start Fast

    New to StackSats? Use the guided onboarding path.

    Quickstart

  • Run Your First Strategy

    Create a custom strategy and run validate/backtest/export.

    First Strategy Run

  • Interactive Notebook Demo

    Explore a runnable marimo notebook preview for the model example workflow.

    Notebook Demo

  • Know the Contract

    Understand framework-owned invariants and user-owned hooks.

    Framework Boundary

  • CLI and Outputs

    Use lifecycle commands and inspect artifact conventions.

    CLI Commands

  • Model + Backtest Internals

    Deep-dive on feature engineering, scoring, and metrics behavior.

    Model Internals | Backtest System

  • Validation + Release

    Operational checklists for strategy quality and maintainers.

    Validation Checklist | Release Guide

What StackSats Gives You

  • Deterministic, invariant-enforced allocation behavior.
  • Clear separation between strategy intent and framework mechanics.
  • Reproducible lifecycle workflows for validate, backtest, and export.
  1. Quickstart
  2. Notebook Demo
  3. First Strategy Run
  4. Framework Boundary
  5. Model Internals
  6. CLI Commands