FAQ Guide Open App →

Frequently Asked Questions

Quick answers to the most common questions about HypeTrade.

Credits & Billing

How do credits work?

Every HypeTrade subscription includes a monthly allotment of credits:

  • Standard: 50 credits/month
  • Pro: 200 credits/month
  • Trial: 10 credits (one-time)

Credits are used for backtesting and AI analysis. They refill automatically at the start of each billing cycle. Your balance is tracked in real time on the Account tab.

How much does a backtest cost?

Backtest credit cost depends on how many symbols you test and the lookback period:

Formula: base + (0.2 × lookback_days)

  • Single/multi symbol: base = number of symbols selected
  • "All Symbols": base = 50 (Standard) or 25 (Pro — discounted!)
  • Day fee: 0.2 credits per lookback day

Examples:

  • 1 symbol, 7 days = 1 + 1.4 = 2.4 credits
  • 5 symbols, 3 days = 5 + 0.6 = 5.6 credits
  • All symbols, 7 days (Pro) = 25 + 1.4 = 26.4 credits
  • All symbols, 7 days (Standard) = 50 + 1.4 = 51.4 credits

The exact cost is shown before you run the backtest, so there are never surprises.

How much does AI analysis cost?

AI analysis of backtest results costs 5 credits per analysis. This charge covers server CPU usage for assembling and processing the analysis request. The AI sends your results to Claude (Anthropic) to get strategy recommendations — this uses your own Anthropic API key, so you also pay the API cost directly (roughly ~$0.09 per review).

If you don't have an Anthropic API key set up, the app will prompt you to add one in Setup → API Keys.

What happens when I run out of credits?

When your credit balance hits zero:

  • Live trading continues — credits are only for backtesting and AI analysis. Your bot keeps running normally.
  • Backtests are blocked — you'll see an "Insufficient Credits" error showing your balance, the cost, and the shortfall.
  • Buy more anytime — credit packs are available in the Account tab.
How do I buy more credits?

Go to Account → Credit Packs and choose a pack:

PackCreditsPrice
Starter25$4.99
Value100$14.99
Power500$49.99

Purchased credits stack on top of your monthly allotment and never expire. They carry over across billing cycles.

What the Bot Does

How does HypeTrade work at a high level?

HypeTrade is an automated perpetual futures trading bot on Hyperliquid. It combines Elliott Wave analysis with a multi-indicator scoring system to make long, short, or hold decisions.

Here's the simplified flow:

  1. Data fetch — the bot pulls the latest candle data from Hyperliquid at your selected time interval (5m, 15m, 1h, etc.)
  2. Indicator calculation — 15 technical indicators (RSI, MACD, VWAP, Elliott Wave, Gann Fan, Bollinger Band Width, and more) each produce a score between -1.0 and +1.0
  3. Composite score — indicator scores are multiplied by their weights and summed into a single composite score
  4. Threshold check — if the composite exceeds your long threshold, the bot goes long. Below the short threshold, it goes short. Otherwise, it holds.
  5. Order execution — market or limit order is placed on Hyperliquid with your configured leverage and position size
  6. Exit management — trailing stop loss, decay aggressiveness, and grab-and-go targets manage the position until exit
What is "signal health" and "cycle maturity"?

The bot needs roughly 200+ cycles of data before its signals stabilize. During early cycles, the indicators are still "warming up" — they don't have enough historical data to produce reliable scores.

On the Live tab you'll see cycle count and signal health indicators. Once the bot has run 200+ cycles on your selected interval, you can trust the signals more. Before that, expect more noise.

What decisions does the bot make?

Every cycle, the bot outputs one of three decisions:

  • LONG — composite score exceeds the long threshold → open a long position (betting price goes up)
  • SHORT — composite score drops below the short threshold → open a short position (betting price goes down)
  • HOLD — composite score is between thresholds → do nothing (or maintain current position with exit management)

The long and short thresholds are configurable — higher thresholds mean fewer but higher-conviction trades.

Supported Exchanges

Which exchanges does HypeTrade support?

Hyperliquid is the only supported exchange. HypeTrade trades perpetual futures (perps) exclusively on Hyperliquid's decentralized exchange.

Hyperliquid was chosen for:

  • Low fees (maker/taker)
  • High throughput and fast execution
  • No KYC — connect with a wallet private key
  • On-chain transparency
Can I sweep profits to Coinbase?

Yes. HypeTrade supports profit sweeps to Coinbase via USDC on Base. You can configure automatic or manual transfers of realized profits from Hyperliquid to your Coinbase account.

Security

How are my API keys stored?

Your API keys are encrypted at rest using Fernet symmetric encryption (AES-128-CBC with HMAC-SHA256). Keys are:

  • Never stored in plaintext — encrypted immediately on submission
  • Encrypted at the application layer before reaching the database
  • Stored in AWS DynamoDB with additional AWS-managed encryption at rest
  • Per-user isolated — each user's keys are encrypted with separate encryption context
What infrastructure does HypeTrade run on?

HypeTrade runs entirely on AWS:

  • ECS Fargate — each user's bot runs as an isolated container task. Standard tier uses FARGATE_SPOT for cost efficiency; Pro tier uses on-demand FARGATE for guaranteed uptime.
  • DynamoDB — user data, trade history, and encrypted keys
  • AWS KMS — key management for encryption operations
  • EFS — per-user persistent storage for bot configuration
  • Cognito — authentication and user management

Bot tasks are per-user isolated — your bot runs in its own container with its own filesystem. No shared state with other users.

Tier Differences

HypeTrade offers two subscription tiers. Both get full trading capabilities — Pro unlocks AI features and more backtest capacity.

Feature Standard ($42/mo) Pro ($69/mo)
Live trading bot✅ 1 bot✅ 1 bot
All time intervals✅ 5m, 15m, 1h, etc.✅ 5m, 15m, 1h, etc.
Save & load presets
Monthly credits50200
All-symbols backtest cost50 base credits25 base credits (discounted)
AI analysis of backtest results
AI-powered strategy refinement
AI live bot monitoring & adaptation
AI optimization whitelist✅ Control which settings AI can adjust
Copy Trading
Trial$7.77 / 7 days$14.99 / 7 days
💡 Tip
Both tiers trade with the exact same engine, indicators, and strategies. Pro adds the AI layer and more backtest credits to help you optimize faster.

Refund Policy

When you switch between Standard and Pro tiers, we calculate a fair refund based on two factors:

  1. Time remaining in your current billing period
  2. Credits remaining from your monthly allotment

If you haven't used any of your monthly credits, you get a full refund for the remaining time — no penalty. If you've used some credits, the refund is proportionally reduced: the more credits you've used, the smaller the refund.

📐 Formula
refund_pct = time_remaining_pct × credits_remaining_pct

Exception: If you haven't used ANY credits (100% remaining), the formula simplifies to just the time-based refund — no credit penalty applied.

Example

Say you're on Pro ($69/mo) with a 30-day billing cycle:

But if you haven't touched your credits at all:

⚠️ Note
Purchased credit packs (Starter, Value, Power) are excluded from the refund calculation. The formula only considers your monthly allotment credits.

Beginner's Guide

Quick Start (30 Seconds)

Getting your bot trading takes about 30 seconds:

  1. Sign up and complete onboarding — you'll choose a preset and enter your Hyperliquid wallet private key
  2. You land on the Dashboard (Live tab)
  3. Press "Start Bot" — that's it. The bot begins trading with whichever preset you chose during onboarding.

The bot starts running in the cloud immediately. No installation, no server setup. It trades 24/7 until you stop it.

[Screenshot: Dashboard — Start Bot button]
💡 Tip
During onboarding you'll be asked for your Hyperliquid wallet private key (not your seed phrase). Create a fresh wallet for trading — don't use your main wallet. The key is encrypted immediately with Fernet encryption and never stored in plaintext.

Choosing a Preset

Navigate to the Setup tab. You'll see three built-in presets — each represents a different trading personality:

PresetStyleRiskDescription
Conservative Low risk, slow 🟢 Low Smaller positions, tighter stops, higher signal thresholds. Fewer trades but higher conviction. Good for beginners or larger accounts.
Trend Follower Follow momentum 🟡 Medium Follows prevailing market momentum with wider stops and moderate position sizing. Balanced risk/reward. The all-rounder.
Momentum Aggressive, fast 🔴 High Starts with 5× leverage and lower signal thresholds for more frequent entries. Quick profit-taking with aggressive trailing stops. Higher leverage = higher risk.

Click a preset → all settings auto-populate. You can start trading immediately or fine-tune the individual settings.

[Screenshot: Setup Tab — Preset Selector showing the three preset cards]

Pro Features: Custom Configuration

Beyond the presets, every setting is individually customizable from the Setup tab. This is where experienced traders dial in their edge. Settings are organized into sections:

General Settings

These control your core risk parameters — how much you trade and when the bot enters or exits.

SettingWhat It DoesImpact
Leverage Multiplier for position size relative to balance (1×–20×) Directly scales both wins and losses. Start at 2× until your win rate is proven.
Position Size Percentage of balance to use per trade Combined with leverage, this determines your total exposure per trade.
Order Type Market (instant fill, taker fee) or Limit (set price, maker fee, may not fill) For exits — especially stop losses — market orders are safer. Limit orders save on fees but risk not filling.
Long Threshold % Composite score must exceed this to trigger a long entry The single biggest lever on trade count AND quality. Higher = fewer but higher-conviction trades.
Short Threshold % Composite score must fall below this to trigger a short entry Same logic as long threshold, but for short positions.
[Screenshot: Setup Tab — General Settings section with callouts]

Advanced Settings (Exit Behavior)

Fine-tune how the bot manages positions after entry — trailing stops, profit targets, and exit timing.

SettingWhat It DoesImpact
Target Wave Multiplier Profit target as a multiple of wave amplitude Controls the size of your wins. Higher = larger wins but fewer completed exits.
Max Loss Std Multiplier Hard stop-loss width based on volatility Tighter stops cut losses fast but risk stopping out on normal volatility. The absolute worst-case exit point per trade.
TSL Multiplier Trailing stop-loss distance — how far behind price the stop trails Smaller = tighter trail = locks in profit faster but exits earlier. Larger = gives trades more room to breathe.
Decay Aggressiveness How fast the trailing stop tightens over time Higher decay = the stop chases price faster, limiting damage from entries that initially moved favorably then reversed.
Grab & Go Quick profit-taking on price spikes — exits immediately when a target is hit Captures windfall profits but may exit trades that would have run further.
TSL Post-Peak Grace Bars After recording a new highest profit, ignores trailing stop exits for N bars on the active timeframe. The trailing stop still updates and tightens — only the exit decision is delayed. Higher = more tolerance for pullbacks after momentum surges. Does not affect max loss, time exits, wave-over, or indicator flip exits.
[Screenshot: Setup Tab — Advanced Settings (wave multipliers, TSL, decay, grab-and-go, grace bars)]

Indicator Weights

Each of the 15 technical indicators contributes to the composite score. Higher weight = more influence on trade decisions. Weights should sum to approximately 15.0.

IndicatorWhat It MeasuresWhy It Matters
VWAPVolume-weighted average priceInstitutional fair value anchor — entering near VWAP means entering near where most volume traded
VWAP FMSVWAP flow momentum signalDirectional pressure of volume-weighted flow
VWAP MRVWAP mean reversionDistance from VWAP — signals potential mean reversion
SMASimple moving average crossoversClassic trend direction confirmation
EMAExponential moving average crossoversFaster-reacting trend signal vs SMA
BBWBollinger Band WidthVolatility squeeze detection — narrow bands often precede breakouts
VWAP DEVVWAP deviation bandsStandard deviation from VWAP — overbought/oversold relative to volume profile
OFIOrder flow imbalanceBuy vs. sell pressure — leading indicator of price direction
KCKeltner ChannelsATR-based volatility bands — breakouts signal strong momentum
RSIRelative Strength IndexOverbought/oversold filter — prevents entries when momentum is exhausted
MACDMoving Average Convergence DivergenceTrend momentum and direction — histogram slope confirms momentum building or fading
Gann FanTime-price geometric anglesNatural support/resistance angles used by institutions — improves entry precision
VelocityRate of price changeMomentum gate — prevents entries during stale/sideways markets
Elliott StructureElliott Wave pattern recognitionIdentifies where price is in its cycle — entering at wave 2/4 pullbacks dramatically improves timing
Elliott FibFibonacci levels within Elliott wavesPrecise entry/exit targets within wave structures
💡 Tip
Setting a weight to 0.0 effectively disables that indicator. Weight values must be multiples of 0.5 (0.0, 0.5, 1.0, 1.5, etc., up to 5.0). If you increase one weight, decrease another to keep the total near 15.0.
[Screenshot: Setup Tab — Indicator weight table showing all 15 indicators with slider controls]

Indicator Sub-Settings

Each indicator has its own configuration — thresholds, periods, and sensitivity controls. Click the ⚙️ gear icon next to any indicator in the weight table to open its specific settings.

For example:

These are power-user controls. The defaults are sensible for most market conditions — only adjust if you understand the indicator's behavior.

[Screenshot: Indicator sub-settings modal (gear icon click) — e.g. RSI with overbought/oversold sliders]

Save & Apply

After configuring your settings:

  1. Name your config — enter a name in the config name field at the top of the Setup tab. This saves it to your personal preset library.
  2. Click "Save" — stores the configuration. You can load it later from the preset dropdown.
  3. Click "Apply" — saves your settings to the bot's configuration file. If the bot is running, you must Stop and Start it to pick up new settings. The bot reads config.json once at boot — there is no hot-reload.
[Screenshot: Setup Tab — Config name input field, Save button, and Apply button highlighted]
⚠️ How Apply Works
Apply writes your settings. The bot reads its config once at startup. To use new settings, stop your bot and start it again.

Live Tab

After applying settings, the app navigates to the Live tab automatically. This is your real-time dashboard — everything you need to monitor at a glance.

Bot Status Bar

At the top you'll see:

Position Card

When the bot holds an open position, you'll see:

Metric Cards

Indicator Breakdown

Below the metric cards, you'll see each individual indicator's contribution to the composite score. This helps you understand why the bot is making a particular decision — which indicators are bullish, which are bearish, and how much each one contributes.

Session Balance Chart

A live chart showing your account balance over time with adaptive bucketing — automatically adjusts time resolution based on how long your session has been running. Useful for tracking balance trends within a single bot session.

Exit Reason Codes

When a position closes, the position card displays the exit reason as a color-coded badge:

Gann Fan Visualization

An interactive Gann Fan angle display rendered directly on the Live tab. Visualizes the geometric price-time angles used by the Gann Fan indicator for support and resistance levels.

Real-Time WebSocket

The entire Live dashboard updates in real time via WebSocket — no polling. Price, P&L, indicator scores, and position data stream directly to your browser with sub-second latency.

[Screenshot: Live Tab — full dashboard with numbered callouts: ① Status Bar, ② Position Card, ③ Metric Cards, ④ Indicator Breakdown, ⑤ Session Balance Chart, ⑥ Gann Fan]

P&L Tab

The P&L (Profit & Loss) tab gives you a comprehensive view of your trading performance.

Cumulative P&L Chart

A running total of your realized gains and losses over time. The line trends up when you're profitable, down when you're losing. Useful for spotting sustained profitable periods vs. drawdowns.

Trade History Table

Individual trades listed with entry price, exit price, P&L (both percentage and cash), and trade duration. Sortable and filterable by time range.

Performance Metrics

Config Performance

See which preset or config was active during which trades. Helps you compare whether your manual tuning is outperforming the base presets.

[Screenshot: P&L Tab — cumulative chart, trade table, and performance metrics with section labels]

AI Optimization (Pro only)

The AI tab is where HypeTrade's machine intelligence adapts your strategy over time. Available on the Pro tier.

AI Optimizer Frequency

A slider from 500 to 5,000 cycles controls how often the AI reviews your bot's recent performance and suggests adjustments to weights, thresholds, and exit parameters.

Lower Frequency (500 cycles)Higher Frequency (5,000 cycles)
Adaptation speed Faster — reacts quickly to volatility shifts and market regime changes Slower — takes longer to respond to market changes
Cost Higher — ~$0.09 per Anthropic API review, more frequent = more spend Lower — fewer API calls, cheaper to run
Stability Less stable — may over-fit to short-term noise More stable — averages out noise, avoids over-fitting
Best for Volatile markets, new strategies being refined Stable markets, strategies you've already dialed in

The AI reviews your bot's recent performance data and proposes incremental improvements — changing values by 10–30% at most. Over time, this creates a compounding optimization effect.

AI Optimization Whitelist (Pro)

Control exactly which settings the AI is allowed to adjust. This is organized by section:

💡 Whitelist Strategy
Pros of limiting: Better stewards of credits and API token spend. Lock settings you've already perfected so the AI doesn't un-optimize them.

Cons of limiting: The AI has fewer levers to work with, which may limit its ability to find improvements. A wider whitelist gives the optimizer more room to discover better configurations.
[Screenshot: AI Tab — frequency slider and optimization whitelist with section toggles]

Backtesting

Test your strategy against historical data before risking real money. Backtesting uses credits (see Credits & Billing).

Credits Required

Every backtest costs credits based on symbols and lookback days. The formula: base + (0.2 × lookback_days). The exact cost is displayed before you run — review it and confirm.

Symbol Selection

Lookback Days

Choose 1–7 days of historical data. More days = more data points = more robust results, but costs slightly more credits (0.2 per day).

Understanding Results

After the backtest completes, you get a comprehensive results view:

Chart markers:

Below each chart you'll see per-symbol metrics: P&L, trade count, win rate, and Sharpe ratio.

[Screenshot: Backtest Tab — results view with charts, sort controls, and per-symbol metrics]

Dropped Symbol Refunds

If any symbols are dropped during a backtest — either because of data errors or because no trading signals were generated — you'll automatically receive a credit refund.

"Dropped" means either:

  1. The symbol errored out (data couldn't be fetched or processed)
  2. The symbol had zero trades (your settings didn't generate any signals for that symbol)

AI Strategy Feedback (Pro)

After a backtest completes, Pro users can get AI-powered analysis:

  1. Select a symbol to analyze (or analyze all)
  2. Wait for analysis — the AI reviews your results and generates reasoning + suggested parameter changes
  3. Review the suggestions — the AI explains why it's recommending each change, referencing patterns across symbols
  4. Save as a new preset — the suggested config becomes available in your preset dropdown
  5. Iterate — backtest again with the new config, get more feedback, refine until improvements plateau
💡 The Optimization Loop
The most effective workflow: Backtest → AI Feedback → Save → Backtest again. Each iteration refines the strategy. When P&L stops improving meaningfully, your config is dialed in. Apply it from the Setup tab and start the bot.

Trades Tab

A complete log of every trade your bot has executed:

Filterable by time period (1h, 6h, 24h, 7d, 30d, all). Use this alongside the P&L tab to audit individual trades and understand what went right or wrong.

CSV Export

Download your trade history as a CSV file with date-range filtering. Select a start and end date, then export — useful for tax reporting, external analysis, or record keeping.

[Screenshot: Trades Tab — trade history table with exit reason codes, CSV export button, and date-range filter]

Copy Trading (Pro only)

Mirror the trades of any Hyperliquid wallet — no permission needed. Paste a wallet address and HypeTrade handles the rest.

How It Works

  1. Paste any Hyperliquid wallet address — find a top trader on the leaderboard or enter an address you already follow
  2. Choose allocation mode:
    • Proportional — mirrors the trader's position sizes relative to their account balance
    • Concentrated — uses your full configured position size regardless of the source trader's sizing
  3. Choose timing:
    • Immediate entry — copies existing open positions right away
    • Wait for next trade — only enters when the source wallet opens a new position

Leaderboard Discovery

Browse the built-in leaderboard to find top-performing Hyperliquid traders. Sort by P&L, win rate, or trade frequency to find wallets worth copying.

Copy History & P&L

Track every copied trade with full P&L visibility. See which source wallets are generating profits and which aren't — adjust or stop copying accordingly.

Fees

💰 Copy Trading Fees
HypeTrade charges 0% on entries and exits. The only fee is 1% of realized profits, and only when profit exceeds $1.00. If a copied trade loses money or profits are under $1.00, you pay nothing.
[Screenshot: Copy Trading Tab — wallet input, allocation/timing selectors, leaderboard, and copy history]

Marketplace

Buy proven strategy presets from other traders — or sell your own configs with live performance tracking.

Buying Presets

Selling Presets

Seller Dashboard

Track your marketplace earnings, see which presets are selling, and claim your earnings with a single click.

ℹ️ Marketplace Economics
Sellers keep 92.23% of every sale. Listings that don't sell within 7 days expire automatically — relist anytime with updated performance data.
[Screenshot: Marketplace Tab — preset listings with performance stats, buy button, and seller dashboard]

Logs Tab

See what the bot is doing on its terminal — in real time.

The Logs tab streams the live output from your bot process, including:

This is your debugging tool. If something seems off — the bot isn't trading when you expect, or it's making unexpected decisions — the logs show exactly what's happening and why.

[Screenshot: Logs Tab — real-time terminal output showing cycle data and trade decisions]

Data Management

HypeTrade gives you full control over your data. From the Account tab, you'll find a Data Management panel where you can delete, restore, and permanently purge your data.

What You Can Delete

How Trash Works

All deletions are soft deletes. When you delete something, it moves to Trash with a 30-day retention period. During those 30 days, you can:

After 30 days, items in trash are automatically and permanently purged.

Account Deletion

If you request account deletion, your bot will be stopped, your subscription cancelled (with a refund per the refund policy), and all data scheduled for permanent deletion after a 30-day grace period. You can cancel the deletion at any time during those 30 days and everything will be restored.

[Screenshot: Account Tab — Data Management panel showing delete options, trash section with restore/purge buttons]

API Key Setup Guides

HypeTrade needs two API keys to function. Both can be entered during onboarding or later in the Setup → API Keys section. Tap the ℹ️ setup guide hint below each input field for step-by-step instructions.

🔑 Fresh Wallet Private Key (Required)

This is the private key from your Hyperliquid fresh wallet. The bot uses it to place trades on your behalf.

How to get it:
  1. Go to the security section of your fresh wallet
  2. Copy your wallet private key (NOT the seed phrase)
  3. Paste it into the "Fresh Wallet Private Key" field

⚠️ Only deposit what you're comfortable trading with.
⚠️ Do not share this key anywhere else.

🤖 Anthropic API Key (Optional)

This key connects to Anthropic's Claude AI for strategy optimization. It's optional but enables:

How to get it:
  1. Go to console.anthropic.com
  2. Sign up or log in
  3. Navigate to API Keys → Create Key
  4. Copy the key and paste it into the "Anthropic API Key" field

💡 You pay Anthropic directly for AI usage (~$0.09 per optimization review). HypeTrade charges 5 credits per analysis for server processing.

[Screenshot: Setup Tab — API Keys section showing both input fields with hint text and setup guide links]

How It Works

Trade Decision Flow

Every cycle, the bot follows this decision tree — from raw market data to order execution:

flowchart TD
    A["📡 Fetch Candle Data\n(Hyperliquid API)"] --> B["📊 Calculate 15 Indicators\n(RSI, MACD, VWAP, Elliott, Gann, etc.)"]
    B --> C["⚖️ Apply Weights\n(each indicator × its weight)"]
    C --> D["🎯 Composite Score\n(sum of weighted scores, -1.0 to +1.0)"]
    D --> E{"Score vs Thresholds"}
    E -->|"> long_threshold"| F["🟢 LONG\nOpen long position"]
    E -->|"< short_threshold"| G["🔴 SHORT\nOpen short position"]
    E -->|"Between thresholds"| H["⏸️ HOLD\nMaintain current state"]
    F --> I["📝 Place Order\n(market or limit)"]
    G --> I
    I --> J["🔄 Exit Management\n(TSL, decay, G&G targets)"]
    J --> K{"Exit Triggered?"}
    K -->|"Yes"| L["💰 Close Position\nRecord P&L"]
    K -->|"No"| M["↩️ Next Cycle"]
    H --> M
    L --> M

    style A fill:#0ea5e920,stroke:#0ea5e9,color:#f1f5f9
    style D fill:#06d6a020,stroke:#06d6a0,color:#f1f5f9
    style F fill:#22c55e20,stroke:#22c55e,color:#f1f5f9
    style G fill:#ef444420,stroke:#ef4444,color:#f1f5f9
    style H fill:#f59e0b20,stroke:#f59e0b,color:#f1f5f9
    style L fill:#fbbf2420,stroke:#fbbf24,color:#f1f5f9
    

Credit System

How credits flow through the system — from monthly allotment to usage to refund:

flowchart TD
    A["🗓️ Billing Cycle Start"] --> B["💳 Monthly Credit Refill\n(Standard: 50 / Pro: 200)"]
    B --> C["💰 Credit Balance"]
    D["🛒 Purchase Credit Pack\n(Starter/Value/Power)"] --> C
    C --> E{"Use Credits"}
    E -->|"Run Backtest"| F["📉 Deduct: symbols + (0.2 × days)\nPro gets discounted all-symbol rate"]
    E -->|"AI Analysis"| G["🧠 Deduct: 5 credits"]
    F --> H["Updated Balance"]
    G --> H
    H -->|"Balance = 0"| I["⚠️ Backtest Blocked\nLive trading continues!"]
    H -->|"Balance > 0"| C
    C -->|"Switch Tier"| J{"Refund Calculation"}
    J --> K["time_remaining% × credits_remaining%\n(or time% only if 0 credits used)"]
    K --> L["💵 Refund Issued"]

    style A fill:#0ea5e920,stroke:#0ea5e9,color:#f1f5f9
    style B fill:#06d6a020,stroke:#06d6a0,color:#f1f5f9
    style C fill:#06d6a020,stroke:#06d6a0,color:#f1f5f9
    style D fill:#fbbf2420,stroke:#fbbf24,color:#f1f5f9
    style I fill:#ef444420,stroke:#ef4444,color:#f1f5f9
    style L fill:#22c55e20,stroke:#22c55e,color:#f1f5f9
    

Bot Lifecycle

From pressing "Start" to an idle shutdown — the full lifecycle of your trading bot:

flowchart TD
    A["🟢 User clicks 'Start Bot'"] --> B["📁 Provision EFS Directory\n(per-user isolated storage)"]
    B --> C["🚀 run_task on ECS Fargate\n(Standard: SPOT / Pro: On-Demand)"]
    C --> D["⏳ Task Startup\n(container pulls config, loads keys)"]
    D --> E["🔄 Polling Loop\n(fetch data → calculate → decide → execute)"]
    E --> F{"Bot State Check"}
    F -->|"Active trading"| G["📊 Execute Cycle\n(indicator calc → composite → order)"]
    G --> E
    F -->|"No position + idle timeout"| H["💤 Idle Shutdown\n(saves state, stops task)"]
    F -->|"User clicks Stop"| I["🛑 Graceful Stop\n(close position if open, save state)"]
    H --> J["⏹️ Task Stopped\n(ECS task terminated)"]
    I --> J
    J --> K["💾 State Preserved\n(trades, logs, config on EFS)"]
    K --> L["Ready to restart anytime"]

    style A fill:#22c55e20,stroke:#22c55e,color:#f1f5f9
    style C fill:#0ea5e920,stroke:#0ea5e9,color:#f1f5f9
    style E fill:#06d6a020,stroke:#06d6a0,color:#f1f5f9
    style H fill:#f59e0b20,stroke:#f59e0b,color:#f1f5f9
    style I fill:#ef444420,stroke:#ef4444,color:#f1f5f9
    style J fill:#64748b20,stroke:#64748b,color:#f1f5f9
    

HypeTrade Documentation — Built for traders, by traders.
hypetrade.io · support@hypetrade.io