type	documentation
concept	index
project	TrendWatcher-Cloud

📈 TrendWatcher-Cloud

TrendWatcher-Cloud is a defensive-grade execution engine for funding rate arbitrage strategies. Designed at the intersection of financial engineering and distributed systems resilience, the project leverages a modern, Google Cloud-native stack.

🛡️ Core Mandates: Defensive-Grade

Unlike typical trading bots, this engine prioritizes capital integrity over extreme low latency:

• Idempotent Execution: Every order is tracked via deterministic clientOrderId to prevent duplication.
• Circuit Breakers: Completely decoupled opening and emergency liquidation flows.
• Cloud-Native Architecture: Deep integration with Google Secret Manager and Firestore for full forensic auditing.
• Strict Neutrality: Mathematical validations using $\epsilon$ tolerance to ensure real-time BTC/USD balance.

🛠️ Tech Stack

• Language: Python 3.12+
• Connectors: CCXT Standard (async REST polling, ccxt.async_support) — zero marginal cost. ccxt.pro (WebSockets, commercial license) is deliberately not used; see docs/strategy/GRADUATION.md for the profit/resilience gates that would justify switching
• Infra: Google Compute Engine, containerized with Podman (deploy/containerfile/) or bare-metal, supervised by systemd
• Secrets: Google Secret Manager (GSM)
• Monitoring: External Heartbeat (Dead-man's switch) + ntfy.sh / Discord.

⚖️ OpenSource Governance

This repository serves as the Core Engine (Educational Platform). In accordance with our docs/strategy/OPENSOURCE-BLUEPRINT.md, specific strategy parameters, proprietary risk thresholds, and production credentials remain private. This allows the community to collaborate on engine robustness without compromising competitive advantage.

---

This project is part of the TrendWatcher initiative for fostering resilient financial engineering.