Documentation Hub
Documentation
Start with the quick path, then dive into the model, backtest, and API reference when you need depth.
AI-agent-first docs
Generate an API token, connect your AI agent, then go deeper as needed
Stacking Sats provides optimized daily DCA weights so retail users and investors can accumulate bitcoin more effectively. Generate a personal API token and connect an AI agent you run or configure to pull weights on your schedule while you keep execution and custody on your preferred platform.
New user flow: Sign in → open /profile → set plan (dates, budget) → generate a personal API token → your AI agent calls GET /api/v1/agent/signal (optional POST /api/v1/agent/heartbeat); you execute trades on your exchange or venue. Stacking Sats does not custody funds or place orders for you.
Auth: Personal API tokens only — use Authorization: Bearer <token> on every Agent API request.
Freshness
- Last updated: March 22, 2026
What Changed
- Repositioned the docs around AI-agent-first onboarding and personal API tokens.
- Expanded the canonical user-story narrative to define audience, product boundary, and success criteria.
- Rewrote quick start and API guidance for token-only authentication.
- Removed manual-agent and GPT-specific setup guidance from public docs.
Start Here
App onboarding
Get to a working agent fast
Use the shortest path if your goal is to set a plan, generate an API token, and configure your AI agent to pull daily DCA weights.
- Sign in and configure your profile plan
- Generate a personal API token and paste it into your AI agent
- Poll the signal endpoint on your own schedule
Methodology
Understand what the model is doing
Start with the core concepts, then move into weight computation and validation outcomes.
- Interpret the signal correctly
- See how weights are composed
- Review validation and score outputs
Integrations and API
Build against the public contract
Use the Agent API, token authentication, and glossary when you are integrating an AI agent you run.
- Understand the token-based agent contract
- Inspect signal and heartbeat endpoints
- Confirm discovery via `/.well-known/agent-integration.json`
Suggested First 20 Minutes
- 1
Orient yourself with the product
Read the introduction if you are new to Stacking Sats and want the shortest explanation of the app, model, and AI-agent workflow.
- You know whether you are here for app use, methodology, or integration work
- 2
Run the primary user journey
Use the quick start to move from profile setup to optimized daily weights delivered to your AI agent, with trades executed on your chosen platform.
- Profile plan is configured
- API token is configured in your AI agent
- Signal requests succeed
- 3
Decide how deep you need to go
Continue into concepts, model, backtest, or resources depending on whether you need explanation, evidence, or implementation detail.
- New to the product: start with Introduction, then Quick Start.
- Need to integrate an AI agent: open Agent API, then the glossary.
- Need evidence: start at Backtest Overview, then SPD Calculation and Performance Results.
- Need to interpret a signal: open Concepts Overview and Signal Interpretation.