System Requirements Document (SRD)

Project Name: omega-algo

1. Introduction

The omega-algo project is a semi-automated multi-asset trading system designed for personal use by Tsavkoob Yaj. This system leverages technical indicators such as MACD, ADX, and ATR to generate trading signals while allowing the user to manually confirm trades. The system is tailored for multi-asset trading and provides a web-based interface for interaction. The design ensures a balance between algorithmic efficiency and user control, with detailed analytics displayed alongside trade execution options.

This document outlines the requirements, design, and technical specifications for the omega-algo system.

2. System Overview

The omega-algo system is a semi-automated trading platform that:

• Generates trading signals using MACD, ADX, and ATR indicators.
• Allows the user to manually confirm trades via "Buy" or "Sell" buttons.
• Incorporates a trailing stop-loss mechanism set at 2x ATR and customizable take-profit options.
• Provides detailed signal analytics, including MACD charts, ADX values, and ATR values, for informed decision-making.
• Operates as a web-based interface for accessibility and ease of use.

The system is designed for individual traders and supports multi-asset trading across various markets, including stocks, crypto, and forex.

3. Functional Requirements

• As a User, I should be able to view trading signals generated using MACD, ADX, and ATR indicators.
• As a User, I should be able to see detailed analytics, including MACD charts, ADX values, and ATR values, for each signal.
• As a User, I should be able to manually confirm trades by clicking "Buy" or "Sell" buttons.
• As a User, I should be able to set a trailing stop-loss at 2x ATR for each trade.
• As a User, I should be able to set a take-profit level for each trade.
• As a User, I should be able to view a history of executed trades and their outcomes.
• As a User, I should be able to configure basic settings such as preferred assets and risk parameters.

4. User Personas

4.1 Individual Trader

• Description: A self-directed trader who uses the system for personal trading across multiple asset classes.
• Goals:
  • To leverage algorithmic trading signals for better decision-making.
  • To maintain control over trade execution.
  • To manage risk effectively using trailing stop-loss and take-profit mechanisms.
• Pain Points:
  • Lack of reliable tools for multi-asset trading.
  • Difficulty in analyzing complex technical indicators manually.

5. Visuals Colors and Theme

The visual identity of omega-algo is designed to evoke a sense of precision, control, and modernity. Below is the unique color palette for the project:

• Background: #0F1B2D (Deep Navy Blue)
• Surface: #1C2A3A (Slate Gray)
• Text: #E8E9EB (Soft White)
• Accent: #FF6F61 (Vibrant Coral)
• Muted Tones: #4A6572 (Muted Teal)

This palette ensures a professional and sleek interface, with vibrant accents to highlight actionable elements like buttons and signals.

6. Signature Design Concept

The omega-algo homepage will feature an interactive trading dashboard inspired by a futuristic control room.

Key Features:

1. Dynamic Signal Visualization:

   • A live, animated chart displaying MACD, ADX, and ATR values in real-time.
   • Signals will pulse or glow when actionable, drawing the user's attention.

2. Interactive Trade Confirmation Panel:

   • A sleek, semi-transparent panel slides in from the side when a signal is generated.
   • The panel includes:
     • "Buy" and "Sell" buttons with hover animations (e.g., buttons subtly expand and glow).
     • Editable fields for trailing stop-loss (default: 2x ATR) and take-profit levels.

3. Micro-Interactions:

   • Clicking a button triggers a ripple effect animation.
   • Successful trade confirmation displays a confetti burst animation in the accent color (#FF6F61).

4. Ambient Background Animation:

   • A subtle, moving gradient background inspired by market trends (e.g., rising and falling lines).
   • The background color shifts slightly based on the time of day (e.g., cooler tones at night, warmer tones during the day).

This design ensures that the user is immersed in a visually engaging and intuitive trading experience.

7. Non-Functional Requirements

• The system must support real-time data processing for signal generation.
• The web-based interface must be responsive and compatible with major browsers (Chrome, Firefox, Safari, Edge).
• The system must ensure data security and user privacy.
• The interface must load within 2 seconds under normal network conditions.
• The system must handle up to 1,000 concurrent users without performance degradation.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses.

AI Tools

• LangChain
• LiteLLM for LLM routing

Local Orchestration

• Docker
• docker-compose

9. Assumptions and Constraints

• The system will only support a web-based interface initially; no mobile app is planned at this stage.
• The user will manually confirm all trades; no fully automated trading is included.
• The system will focus on multi-asset trading but will require the user to configure specific assets of interest.
• The trailing stop-loss will default to 2x ATR but can be adjusted by the user.

10. Glossary

• MACD (Moving Average Convergence Divergence): A trend-following momentum indicator that shows the relationship between two moving averages of a security's price.
• ADX (Average Directional Index): An indicator used to quantify the strength of a trend.
• ATR (Average True Range): A measure of market volatility.
• Trailing Stop-Loss: A stop-loss order that moves with the market price to lock in profits or limit losses.
• Take-Profit: A pre-set price level at which a trade is automatically closed to secure profits.