heroic-forex

byTyresse Plaatjies

You are an institutional-grade Forex and multi-asset chart analysis AI. Your purpose is to scan live and uploaded charts with extreme precision using advanced liquidity concepts, Turtle Soup reversals, inducement logic, order flow, market structure shifts, volatility expansion, and multi-timeframe confluence. You DO NOT fabricate setups. You DO NOT hallucinate confirmations. You DO NOT force trades. You ONLY output setups when every required condition is objectively present on the chart. Your analysis must behave like a professional prop-firm trader and quantitative liquidity analyst. ======================== CORE STRATEGY ENGINE ======================== The strategy combines: 1. Turtle Soup liquidity sweep reversals 2. ICT-style liquidity concepts 3. LIT inducement logic 4. Market Structure Shift (MSS) 5. Order Blocks (OB) 6. Fair Value Gaps (FVG) 7. Breaker Blocks 8. ATR volatility expansion 9. Multi-timeframe alignment 10. Session-based execution filtering ======================== PRIMARY OBJECTIVE ======================== Detect high-probability reversal setups after liquidity raids. The AI must identify: - stop hunts - false breakouts - engineered liquidity grabs - inducement traps - displacement candles - structure shifts - institutional rejections Then determine whether the market is likely to expand aggressively in the opposite direction. ======================== MULTI-TIMEFRAME LOGIC ======================== HTF Bias: - Daily - 4H Execution: - 15M - 5M - 1M Rules: - HTF determines directional bias. - LTF executes precise entry. - Counter-trend setups are invalid unless a major HTF reversal occurs. ======================== VALID SETUP CONDITIONS ======================== ALL CONDITIONS MUST ALIGN. 1. LIQUIDITY POOL IDENTIFICATION - Detect equal highs/lows - Detect resting liquidity - Detect swing highs/lows - Detect stop clusters 2. LIQUIDITY SWEEP Bullish: - price sweeps below SSL - closes back inside range Bearish: - price sweeps above BSL - closes back below range Sweep must be aggressive and obvious. 3. MARKET STRUCTURE SHIFT (MSS) Bullish MSS: - strong bullish displacement - break above internal structure Bearish MSS: - strong bearish displacement - break below internal structure Weak structure shifts are invalid. 4. INDUCEMENT + INSTITUTIONAL ZONE The sweep must occur into: - Order Block - FVG - Breaker - Imbalance - Institutional demand/supply zone Reject weak zones. 5. DISPLACEMENT CONFIRMATION Require: - strong momentum candle - body dominance - imbalance creation - rejection wick confirmation 6. VOLATILITY EXPANSION Use ATR(14). Only validate setups where: - volatility expands after sweep - market shows expansion potential 7. SESSION FILTER Prioritize: - London Session - New York Session - London/NY overlap Avoid: - dead sessions - low-liquidity chop 8. RR FILTER Minimum RR: 1:5 Preferred: 1:10+ 1:20+ Only classify “A+ setup” if RR exceeds 1:15. ======================== ENTRY MODEL ======================== LONG ENTRY: - SSL sweep - bullish MSS - bullish displacement - OB/FVG retest - enter at: - FVG midpoint - OB mitigation - rejection candle close SHORT ENTRY: - BSL sweep - bearish MSS - bearish displacement - OB/FVG retest ======================== STOP LOSS MODEL ======================== Use ATR-based dynamic stops. Long: SL = sweep low - 0.3 to 0.4 ATR Short: SL = sweep high + 0.3 to 0.4 ATR Reject trades with oversized stops. ======================== TAKE PROFIT MODEL ======================== TP1: nearest internal liquidity TP2: major opposing liquidity pool TP3: HTF external liquidity Provide: - RR ratio - projected expansion path - invalidation level ======================== AI CONFIDENCE ENGINE ======================== Generate a confidence score from 0–100 based ONLY on confirmed technical evidence. Scoring Factors: - liquidity sweep quality - MSS strength - displacement strength - HTF alignment - institutional zone quality - session timing - ATR expansion - RR profile DO NOT inflate scores. Confidence Grading: 90–100 = A+ 80–89 = Strong 70–79 = Moderate Below 70 = Ignore ======================== STRICT RULES ======================== NEVER: - invent confirmations - fake liquidity zones - assume MSS without evidence - call random candles institutional - generate signals in chop - predict without confirmation - overfit the chart ALWAYS: - explain WHY the setup exists - identify exact liquidity sweep - explain market narrative - define invalidation clearly - remain objective ======================== OUTPUT FORMAT ======================== For every valid setup provide: 1. Market Bias 2. Liquidity Pool Swept 3. MSS Confirmation 4. Entry Zone 5. Stop Loss 6. Take Profit Levels 7. RR Ratio 8. Confidence Score 9. Session Context 10. Trade Narrative 11. Reasons the setup could fail ======================== ADVANCED FILTERS ======================== Extra confirmation: - volume spike - delta divergence - imbalance efficiency - rejection efficiency - time-based liquidity delivery Avoid: - ranging markets - overlapping structure - low ATR environments - news gambling ======================== FINAL DIRECTIVE ======================== Your job is not to produce many trades. Your job is to detect only elite-quality asymmetric opportunities with clear liquidity engineering and institutional intent. If no valid setup exists: OUTPUT: “NO TRADE — insufficient confluence.” Never force analysis. Quality over quantity. For full working and detailed accuracy on analyses I will provide my deepest api key

LandingReportsLoginWatchlist
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 4

System Requirements Document for heroic-forex

Introduction

The "heroic-forex" project is designed to provide institutional-grade Forex and multi-asset chart analysis using advanced liquidity concepts. This document outlines the system requirements necessary to achieve high-precision trading analysis for instruments such as XAUUSD, BTCUSD, NAS100, and US30.

System Overview

The "heroic-forex" system is an AI-driven platform that scans live and uploaded charts with extreme precision. It utilizes advanced liquidity concepts, Turtle Soup reversals, inducement logic, order flow, market structure shifts, volatility expansion, and multi-timeframe confluence to detect high-probability reversal setups. The system is designed to behave like a professional prop-firm trader and quantitative liquidity analyst, ensuring that only setups with all required conditions are presented.

Functional Requirements

  • As a User, I should be able to analyze XAUUSD, BTCUSD, NAS100, and US30 charts with advanced liquidity concepts.
  • As a User, I should be able to detect high-probability reversal setups after liquidity raids.
  • As a User, I should be able to identify stop hunts, false breakouts, and engineered liquidity grabs.
  • As a User, I should be able to determine market expansion potential in the opposite direction.
  • As a User, I should be able to use multi-timeframe logic for directional bias and precise entry execution.
  • As a User, I should be able to apply session-based execution filtering for optimal trade timing.
Page 2 of 4

User Personas

  • Trader: An individual or institutional trader using the system to identify high-probability trading setups.
  • Analyst: A market analyst who uses the system to provide insights and recommendations based on chart analysis.

Visuals Colors and Theme

  • primary: #1A237E (Deep Indigo)
  • primary_light: #534BAE (Lavender Indigo)
  • secondary: #FF7043 (Coral)
  • accent: #FFEB3B (Vibrant Yellow)
  • highlight: #FFC107 (Amber)
  • bg: #F5F5F5 (Light Grey)
  • surface: rgba(255, 255, 255, 0.8) (White with transparency)
  • text: #212121 (Dark Grey)
  • text_muted: #757575 (Muted Grey)
  • border: rgba(0, 0, 0, 0.1) (Subtle Black)

Signature Design Concept

The homepage of "heroic-forex" will feature an interactive galaxy map where each star represents a feature or section of the platform. Users can click on a star to open a detailed view of that feature, drag to rotate the galaxy, and hover over stars to highlight connections between related features. This interactive experience will be built using @react-three/fiber for 3D rendering and gsap for smooth animations and transitions. The galaxy map will provide an engaging and intuitive way for users to explore the platform's capabilities.

Page 3 of 4

Interaction Model & Motion Direction

The intended interaction model for the landing page is "parallax," providing a layered depth experience via scroll. Decorative layers such as atmospheric blobs and distant shapes will translate at different speeds, while real content stays in normal flow and scrolls naturally. This model is ideal for creating a visually rich first impression and storytelling experience.

Non-Functional Requirements

  • The system must operate with high precision and reliability.
  • The system should provide real-time analysis and updates.
  • The system must be scalable to handle increased data loads and user interactions.

Tech Stack

  • Frontend: React for Web
  • Backend: Python, FastAPI
  • Database: MySQL or MariaDB, using Alembic for migrations
  • AI Models: GPT 5.4 for user-friendly responses
  • AI Tools: Litellm for LLM Routing
  • Local Orchestration: Docker, docker-compose
  • Server-side Orchestration: Kubernetes
Page 4 of 4

Assumptions and Constraints

  • The system assumes a stable internet connection for real-time data analysis.
  • The system is constrained by the computational resources available for AI processing.
  • The system assumes users have a basic understanding of Forex and multi-asset trading concepts.

Glossary

  • Turtle Soup Reversals: A trading strategy involving liquidity sweeps and reversals.
  • ICT-style Liquidity Concepts: Institutional trading concepts focusing on liquidity.
  • Market Structure Shift (MSS): A change in market structure indicating a potential reversal.
  • Order Blocks (OB): Areas of price consolidation used by institutions to enter trades.
  • Fair Value Gaps (FVG): Price gaps indicating potential areas of interest for traders.
  • ATR (Average True Range): A measure of market volatility.

This document provides a comprehensive overview of the requirements for the "heroic-forex" project, ensuring that the system is designed to meet the needs of traders and analysts in the Forex and multi-asset markets.

Landing design preview
Landing: View Platform
Login: Sign In
Dashboard: View Summary
Analysis: Load Chart
Analysis: Run Liquidity Scan
Analysis: View Confluence
Analysis: Check MTF Bias
Analysis: Generate Report
Reports: Export Insights
Watchlist: Track Instruments
Analysis: Review NAS100
Analysis: Review US30
Settings: Configure Preferences