[Hoox Developer Hub]

Hoox is a free, open-source, edge-native algorithmic trading framework and automation engine deployed natively to the Cloudflare® Edge Network. By utilizing a distributed microservice architecture, Hoox processes trade signals, evaluates risk parameters, executes order routing, and fires Telegram notifications—all within milliseconds and directly from the edge nodes closest to exchange servers.

Install with bun add -g @hoox-sh/hoox-cli, then hoox onboard (alias hx).

Rendering…

---

🗺️ Choose Your Path

Whether you are a retail algorithmic trader setting up your first automated TradingView® strategies or a quantitative analyst wiring webhooks, this End User tab covers trader-facing setup and operations.

Platform design lives under Architecture and Workers; install/deploy under DevOps; HTTP contracts under API.

1. 🏁 Getting Started

If you are brand new to the Hoox ecosystem, start here to prepare your machine, provision resources, and deploy your first live microservice in under 5 minutes:

• Core Installation — Install @hoox-sh/hoox-cli, clone the monorepo, and run hoox onboard.
• Platform Configuration — Declaratively define environment variables, JSON profile templates, and KV keys.
• 5-Minute Quick Start — Launch local worker runners and execute a simulated webhook trade signal.

2. 🧠 Core Concepts

Understand the underlying technology, low-latency edge architecture, and security layers that protect your api keys:

• Product ecosystem — HOOX vs PYNE vs AXIS vs PyneTS vs pyne-worker.
• How Hoox Works — The end-to-end lifecycle of a trade signal from webhook alert to order confirmation.
• Edge-First Architecture — Why V8 isolates and Cloudflare® Workers outperform traditional VPS architectures by 30-60%.
• Cloudflare® Services Map — How D1, KV, R2, Queues, Vectorize, and Browser Rendering are integrated.
• Idempotency & Durable Objects — Two-phase reserve/commit/release, fail-closed missing DO, and rate-limit Durable Objects.
• Signals & Trade Routing — How parameters map from webhook JSON schemas to live exchange payloads.
• AI Risk Manager — The configurable-cron autonomous risk scanner (1–1440 min), trailing-stop mathematician, and account kill-switch.

3. 🛠️ Operational Guides

Practical runbooks and blueprints for daily operations, local development, and system health maintenance:

• Local Dev & Workspaces — Run, hot-reload, and test workers locally via Bun or Docker container stacks.
• Terminal UI Operations — Launch and navigate the full-screen operations cockpit (hoox tui / @hoox-sh/hoox-tui).
• Interface gallery — Screenshots and GIFs of the CLI, TUI, and dashboard.
• Edge Database Operations — Manage global SQLite schemas, track drizzle migrations, and run D1 queries.
• Secrets & Network Security — Secure Cloudflare® Zero Trust corridors and encrypt sensitive API credentials.
• Test Trading — Sandbox orders with "test": true, dedicated testnet secrets, and D1/dashboard isolation.
• Infrastructure Management — Spin up and inspect KV, Queues, R2, and Vectorize indexes in one command.
• Deploying to Production — Roll out code, bind V8 isolates, and deploy Next.js dashboard consoles.
• Self-Healing & Repair — Diagnose connection dropouts, rotate API keys, and run interactive system repair tools.
• PYNE live trading — Bar-close cron: strategy events → trade-worker. Alerts are a separate webhook.
• AXIS and HOOX — The chart evaluates. The mesh executes. They do not share an order router.

4. 🎓 Step-by-Step Tutorials

Follow guided, end-to-end tutorials to integrate your trade sources and notification handlers:

• TradingView® Webhook Integration — Write customized Pine Script™ v6 indicators that ping the Hoox webhook receiver.
• Telegram Bot Setup — Configure real-time order alerts, P&L reports, and secure chat commands.
• Email Signal Routing — Configure email parsing services to convert raw inbox alerts into edge trade executions.

5. 📖 Reference Material

Deep specifications, schema registries, and command-line manual trees:

• CLI Commands Index — Complete options, positional arguments, and JSON flag trees for the hoox tool.
• API Spec & REST Routes — HTTP endpoints, request payloads, response templates, and edge errors list.
• Configuration Properties — Comprehensive dictionary of all 31 env keys and 16 KV key-value items.

---

📥 Offline Reference & AI Context

Consolidated specifications and LLM context packages are available in the GitHub repository.

---