Getting Started

Welcome to the bonfire.trade documentation.

bonfire.trade is a 1:N algorithmic trading platform (robo-advisor model). Users authenticate via Firebase, connect their Alpaca brokerage accounts via OAuth2, and allocate capital to automated trading strategies.

Architecture at a glance

• Frontend — React + TypeScript + Vite SPA. Talks only to the Go API.
• Backend (API & OMS) — Go services. The Order Management System computes per-user order deltas from a strategy's target portfolio signal.
• Execution — Hatchet workers run durable workflows for any external state mutation (e.g. placing trades), guaranteeing retries and exactly-once execution.
• Data & Signals — Python (Pandas/NumPy) generates signals, pushed over Redis/NATS.

The 1:N rule

Algorithms do not place trades directly. Python generates a target portfolio signal (e.g. 50% AAPL, 50% MSFT). The Go OMS calculates the delta for every subscribed user and generates fractional child orders.

This site

These docs are built with VitePress and deployed to Cloudflare Pages at docs.bonfi.trade. See agent_docs/ci/cloudflare-pages-docs.md for the deploy pipeline.