Product documentation

SagaHalla Oracle Handbook

How to use the Oracle as a Validator, Operator, or Allocator — including decision timing, webhooks, and Allocator safety gates.

Appendices

X.1 Glossary

Term Meaning
Closed bar A completed daily bar the Oracle decides on — not a live tick
5 trading-day lag Validator and Public Proof decisions: the closed bar from five trading days (one week) before the latest publish. Equity stays current.
At publish Latest closed bar, right after the daily pipeline publishes
Consensus The Oracle’s combined model view for a closed bar, expressed as a decision
Decision End-of-day consensus artifact (action context + explainability) for an instrument
Oracle Proof Institutional validation surface (app may label it LIVE LEDGER)
Portfolio Customer sim basket and connected books; owns book scope
Fresh $100K Book / LIVE LEDGER The Oracle’s institutional validation book on Oracle Proof — not a customer brokerage account
Open Proposals Pending paper proposals (Operator and Allocator)
Fill Ledger Institutional paper fills (Operator and Allocator)
Structural admissibility Oracle integrity / pillar checks for a bar — not suitability for you
Pillars Structural checks behind admissibility (analytics, not advice)
Mandate Your versioned automation configuration (instruments, limits, mode)
Decision webhook Signed outbound decision artifact to your URL / stack
Manual Review Default mode — approve trades before routing
Standing Instruction Advanced opt-in — route per your preconfigured permissions
Platform master live gate Platform-wide switch required before any live order submits
Kill switch Pauses Allocator automation without disconnecting
Platform license One-time Allocator activation fee (amount in A.3)
Entitlement Your plan tier and the surfaces it unlocks
Live-submission intent Your preference to allow live order routing (default off)
Broker vault Server-side AES-256-GCM storage (per-row DEK) for trading-scoped API keys; secrets never re-displayed; customer keys are vault-only (not .env)
BookSwitcher UI in Portfolio scope panel to select Your basket (sim) or a customer book; each customer book binds one venue
Your basket Default sim portfolio when no sh_active_book cookie; edited via Compose
Master Sim Institutional matrix / dry_run paper track — shown on Oracle Proof, not Portfolio book scope

X.2 Version at a glance

Field This handbook (v1.10 / 2026-08-31)
App app.sagahalla.com
Billing sagahalla.com/account
Webhook formats standard and tradingview — see Settings → Webhooks → Integration guide
Webhook general acknowledgment Required before creating / using decision webhooks
Webhook use-and-risk acknowledgment Required before execution-ready / TradingView format
Standing Instruction acknowledgment Required in Allocate before leaving Manual Review
Paper / sandbox disclosure Shown on first paper sessions
Allocator Available for entitled accounts (Alpaca or Coinbase per book); live routing only when all gates in D.12 clear