Skip to main content
The agent-worker is the autonomous central nervous system of the Hoox trading platform. Operating on a continuous 5-minute Cloudflare Cron trigger, it acts as an intelligent sentinel: it monitors open exchange positions, mathematically scales trailing stop-losses, and deploys a multi-provider fallback AI engine to analyze market conditions, audit risk, and send real-time summaries to your phone.

​
🛡️ 1. Automated Risk Protection Engine

Every 5 minutes, agent-worker executes a multi-point risk diagnostic loop across all active exchanges:

​
A. Trailing Stop-Loss Mathematics

Rather than using static stops that leave profits exposed, the risk engine calculates a dynamic trailing stop-loss at the V8 compiler level:
  • The Formula: Trailing Stop Price (Long)=Peak Price×(1−Trailing Deviation %)\text{Trailing Stop Price (Long)} = \text{Peak Price} \times (1 - \text{Trailing Deviation \%})
  • If a LONG trade entry is at \100andhasaand has a2%trailingdeviation,theinitialstop−lossisplacedattrailing deviation, the initial stop-loss is placed at$98$.
  • If the market price rallies to a peak of \120,thestop−lossisautomaticallyadjustedupto, the stop-loss is automatically adjusted up to $117.60$.
  • If the price declines from \120downtodown to$117.60,thestopistriggeredattheexchangelevel,lockingina, the stop is triggered at the exchange level, locking in a $17.60$ profit. The stop never moves downward.

​
B. Scaled Take-Profits (Partial Fills)

To manage extreme market swings, the agent-worker supports multi-target scaling:
  • Target 1 (3%3\% Profit): Automatically flattens 25%25\% of open position size.
  • Target 2 (5%5\% Profit): Flattens another 25%25\% and moves the stop-loss of the remaining 50%50\% to break-even, eliminating downside risk.

​
C. Max Daily Drawdown & Global Kill Switch

If high volatility causes unexpected stop-outs, the agent-worker aggregates your real-time realized P&L:
  1. Calculates cumulative daily loss: Daily Drawdown %=Starting Daily Balance−Current BalanceStarting Daily Balance×100\text{Daily Drawdown \%} = \frac{\text{Starting Daily Balance} - \text{Current Balance}}{\text{Starting Daily Balance}} \times 100
  2. If the drawdown exceeds your KV threshold (e.g. trade:max_daily_drawdown_percent is 5), the agent-worker immediately triggers the Global Kill Switch by writing trade:kill_switch = true to CONFIG_KV.
  3. Calls the trade-worker service binding to submit immediate market close orders, flattening all active positions across all exchanges near-instantaneously.

​
🤖 2. Multi-Provider AI Gateway & Reasoning

Behind the scenes, agent-worker governs a Multi-Provider AI Gateway (supporting 5 major providers) with built-in resilience. If you query the bot for trade advice, market summaries, or risk audits, the gateway processes the request through an automatic fallback chain:

​
A. The Resilient Provider Fallback Chain

​
B. Custom Telemetry & Chat Endpoints

The gateway exposes professional endpoints for secure inter-worker and external integrations:
  • POST /agent/chat — Accepts user prompts and handles SSE (Server-Sent Events) streaming responses.
  • POST /agent/vision — Analyzes charts, balance screenshots, or trading signals from Base64 images.
  • POST /agent/reasoning — Extended thinking queries with reasoning models (o1, DeepSeek). Respects thinking_effort levels.
  • GET /agent/usage — Detailed token usage and cost metrics across all 5 providers, including per-provider input/output tokens and cumulative USD cost.
  • GET /agent/health — Health check for all AI providers — returns latency and status for each provider in the fallback chain.
You can adjust all AI gateway defaults, Cron check intervals, and trailing deviations in real-time by writing to your KV configurations. No code deployments are ever required to tune your risk profile.

​
🔗 Next Steps

Last modified on June 17, 2026