How It Works

The architecture in one diagram

┌─────────────────────────────────────────────────────────────┐
│  YOU (browser)                                              │
│  https://aetherion.app                                      │
│        │                                                    │
│        │ HTTPS                                              │
│        ▼                                                    │
│  Aetherion API (Vercel serverless functions)                │
│        │                                                    │
│        ├── Yahoo Finance (free market data)                 │
│        ├── Groq AI (free LLM inference)                     │
│        └── TradingView (embedded chart widget)              │
└─────────────────────────────────────────────────────────────┘

Aetherion runs as a cloud-hosted web application. All analysis happens server-side via API endpoints. No installation or local setup required — just visit the site and log in.

Step 1 — Live check

The server-status badge in the top-right corner shows green when the API is reachable. All features — scanning, AI chat, reports — are available directly in your browser.

Step 2 — Balance + pair input

You enter your account balance (the math uses real numbers — not assumed defaults) and pick either:

• One pair — runs a single-pair v5.0 analysis (~25 seconds across 7 timeframes)
• All N pairs — full watchlist scan (live count from your TradingView watchlist), ~30 seconds per pair
• Last cached — instantly loads the most recent full scan

Step 3 — The scan loop

For each pair, the scanner does this:

1. Set the chart symbol (OANDA prefix preferred, FX as fallback)
2. For each timeframe in [W, D, H4, H1, M30, M15, M5]:
   • Switch the chart to that timeframe
   • Fetch the last 30 OHLCV bars
   • Detect swing highs and lows (5-bar pivot lookback)
   • Classify structure: HH+HL = bull, LH+LL = bear, mixed = range
   • Score momentum (close-to-close % over last 10 bars)
   • Combine into a trend vote (structure weighted 2x over momentum, per v4.4)
   • Detect engulfing candle on the last two bars
3. Take a live quote
4. Compute alignment across all five timeframes
5. Compute the v5.0 H1+M15 match gate (both must be colored, same direction)
6. Detect setup-pending (range on H1 within 0.3% of the H1 AOI)
7. Detect round-number confluence (within 0.3% of a major round level)
8. Score the grade (alignment + HTF agreement bonus + round-number bonus)

Step 4 — The eight-section report

Section 1: Header

Balance, date, mode (Conservative 2026), risk amount in dollars (0.5% of balance), minimum grade, rules version.

Section 2: Scan summary table

Every pair from your live TradingView watchlist as rows, with a 7-cell TF heatmap (W/D/H4/H1/M30/M15/M5) and a sparkline column. Each heatmap cell is a marker: 🟢 bull, 🔴 bear, ⚪ range, 🟡 setup pending. Asterisk (*) means weak (structure or momentum only). Up/down arrows (↗/↘) mark engulfing candles. 💠 means within 0.3% of a psychological round number. ⭐ means B+ qualifying.

Section 3: Top-3 grading

For the three highest-graded pairs, a Three-Pillars analysis: Trend (HTF direction + alignment), AOI (round-number / structure proximity), Entry Signal (engulfing on M15 yet?). Each pillar is ✅ pass, ⚠️ partial, or ❌ fail. Plus a v5.0 H1+M15 match badge above the pillars showing whether the must-match gate passed.

Section 4: Recommended action

One of three verdicts:

• B+ Qualifying — H1+M15 match + HTF aligned + ≥80% overall alignment. Wait for M15 engulfing at H1 AOI, then enter.
• H1+M15 Match — both colored same direction but overall alignment <80%. Strong scenario, watch for confirmation.
• Setup Pending — Price at H1 AOI but H1+M15 match not there yet. Monitor; do not enter.
• Stand Down — Below threshold. Market-shows-hand-first veto active.

Section 5: Position sizing

Calculates: 0.5% of balance = max risk in dollars. Pairs with default 50-pip SL, 0.01 lot minimum. Computes whether your balance supports the trade. Below ~$2,000 the table flags loss-as-percent-of-account in red and shows a sub-viable warning.

Section 6: Watchlist triggers

Top 5 near-miss pairs with specific conditions to watch for: "M15 close below X + bearish engulf at the H1 AOI retest" type rules. These are what to set price alerts on.

Section 7: Visual

A live screenshot of the top candidate's M15 chart (v5.0 execution chart), captured directly from your TradingView at the moment of analysis. Saved to screenshots/ with a timestamp.

Section 8: Summary / action

One paragraph. What's open, what's pending, what to watch. Reminder that the tool does not execute orders.

Step 5 — You execute (or don't)

Aetherion never places orders. The "Recommended Action" section gives you the entry condition, stop loss, take profit, and lot size. You place the trade yourself, on your broker, under your full control.

The recommendation engine

If you ask Aetherion to analyze a pair that doesn't grade B+, and you've recently run a full watchlist scan, the tool checks the cache for any pair that does grade B+ and offers it as an alternative.

This is the most common path: you have an opinion about EUR/USD, the system finds it doesn't qualify but EUR/AUD does. You either switch your attention or wait for the EUR/USD setup to mature.

Limitations

• Latency. Full watchlist scan is ~6 minutes because the chart navigation between timeframes is sequential. There's no parallelism — you have one TradingView instance.
• Single-user. Each user runs their own server against their own TradingView. The web layer is local-only.
• No fundamentals. The system reads price and structure, not news or sentiment. The news_and_fundamentals rule says to check ForexFactory yourself before entering.
• Pattern detection is simple. The engulfing detector is a basic body-engulf check. It doesn't detect head-and-shoulders, triangles, or wedges automatically — those require visual review.
• No backtest engine yet. Future work. For now, you log trades to trade_log.json and review outcomes manually.