📋 Kereskedési szabályok

A kereskedési szabályok előre meghatározott feltételek, amelyek segítenek fegyelmezetten kereskedni. A rendszer automatikusan figyeli a pozícióidat, és riasztást küld, ha egy szabály teljesül. Így többé nem felejtesz el fontos teendőket.

A kereskedési szabályok rendszer:
• Automatikusan emlékeztet a fontos szabályokra
• Figyelmeztet a kockázati limitek megsértésekor
• Segít a szabálybetartás dokumentálásában és elemzésében
• Támogatja a különböző kereskedési stílusokat (opciók, részvények, stb.)

A legtöbb kereskedőnek fejben vannak a szabályai, de a küzdelem hevében elfelejtik őket. Példa: "50%-os nyereségnél zárj" — de aztán az ember még nagyobb nyereségben reménykedik, és lekési a kiszállást. A kereskedési szabályok automatikusan emlékeztetnek!

"Plan your trade, trade your plan" — a szabályrendszerrel ez az alapelv valósággá válik.

🔧 Rendszer-presetek
A rendszer által előre meghatározott szabályok, amelyeket egy kattintással aktiválhatsz. Ezek bevált kereskedési gyakorlatokon alapulnak, és a Singularity Trader csapata gondozza őket.

Példák:
• "50%-os profit take" — zárás a maximális nyereség 50%-ánál
• "21 DTE Management" — figyelmeztetés 21 nap hátralévő futamidőnél
• "200%-os stop-loss" — zárás a prémium 2x-es veszteségénél

✏️ Felhasználó által meghatározott (egyéni)
Saját szabályok, amelyeket te magad hozol létre, és amelyek pontosan illeszkednek a kereskedési stílusodhoz. Te határozod meg a nevet, a feltételt és a műveletet.

Minden szabálynak van egy érvényességi köre, amely meghatározza, mely pozíciókra vonatkozik:

Scope	Példaszabály	Alkalmazási eset
🎯 Pozíció	"Ezt az AAPL-pozíciót +20%-nál eladni"	Egyéni trade-terv
🏦 Konto	"Ebben a kontóban max. 30% buying power"	Konzervatív IRA-konto
💼 Portfólió	"Sosem több mint 5% egy pozícióban"	Általános kockázati szabály

A pozíció-szabályok egy adott pozícióra vonatkoznak. Lehetővé teszik, hogy minden trade-hez egyéni tervet határozz meg.

Tipikus pozíció-szabályok:
• Stop-loss árfolyam — pl. "Eladni, ha az árfolyam 150 $ alá esik"
• Take-profit cél — pl. "Zárni +20%-nál"
• DTE-alapú — pl. "Zárni 14 DTE-nél"
• ITM-figyelmeztetés — pl. "Görgetni, ha az opció ITM-be kerül"
• Egyéni trade-terv

Alkalmazási eset: Megnyitsz egy trade-et, és rögtön meghatározod, mikor akarod zárni vagy módosítani. A rendszer emlékeztet, amint a feltétel teljesül.

A konto-szabályok egy bróker-kontóra vonatkoznak. Segítenek abban, hogy kontónként eltérő stratégiákat futtass.

Tipikus konto-szabályok:
• Max. buying power kihasználtság % — pl. "Sosem 50% felett"
• Max. nyitott pozíciók száma — pl. "Max. 10 pozíció"
• Engedélyezett eszközosztályok — pl. "Csak részvények, opciók nélkül"
• Max. pozícióméret ebben a kontóban
• Konto-specifikus margin-szabályok

Alkalmazási eset: Van egy konzervatív IRA-kontód és egy agresszív kereskedési kontód. A konto-szabályok biztosítják, hogy betartsd az eltérő kockázati profilokat.

A portfólió-szabályok az összes kontón átívelve érvényesek. Megvédik a teljes vagyonodat.

Tipikus portfólió-szabályok:
• Teljes exposure limit — pl. "Max. a tőke 200%-a"
• Szektor-diverzifikáció — pl. "Max. 20% tech szektorban"
• Max. pozícióméret (összesen) — pl. "Max. 5% egy részvényben"
• Korrelációs limitek — pl. "Figyelmeztetés túl sok hasonló trade esetén"
• Teljes kockázati szabályok

Alkalmazási eset: Bármennyi kontód is van, ezek a szabályok biztosítják, hogy a teljes portfóliód ne váljon túl kockázatossá.

A szabályokat kategóriákba soroljuk aszerint, mikor lépnek életbe:

📥 Entry-szabályok (nyitás előtt)
Ellenőrzések egy pozíció megnyitása előtt:
• 45 DTE entry — kb. 45 napos futamidejű opciók
• Delta 0,30 — short putok 0,30-as deltánál
• IV Rank > 50 — csak magas volatilitásnál eladni
• Earnings elkerülése — nincs trade earnings körül

📤 Exit-/menedzsment-szabályok
Mikor kell zárnod vagy módosítanod a pozíciókat:
• 50%-os profit take — a maximális nyereség 50%-ánál
• 21 DTE menedzsment — 21 nap hátralévő futamidőnél
• 200%-os stop-loss — a prémium 2x-es veszteségénél
• Görgetés ITM esetén

⚠️ Kockázati szabályok
Portfóliószintű határok:
• 1-2%-os szabály — max. kockázat trade-enként
• 5%-os pozícióméret — max. pozíciónként
• 50%-os buying power — sosem lépd túl

🧠 Pszichológiai szabályok
Védelem az érzelmi alapú kereskedés ellen:
• 3 vesztes = szünet
• Nincs bosszú-kereskedés
• Terv a trade előtt

A szabály-motor a rendszer szíve. Folyamatosan figyeli az összes pozíciódat, és ellenőrzi, hogy egy szabály kiváltódik-e:

┌─────────────────────────────────────────────────────────────────┐
│                        SZABÁLY-MOTOR                             │
├─────────────────────────────────────────────────────────────────┤
│  Szabály-definíció (Admin/felhasználó)                          │
│  • Név, leírás                                                  │
│  • Típus: Entry / Exit / Menedzsment / Risk                     │
│  • Feltétel (pl. DTE <= 21)                                     │
│  • Művelet: Alert / figyelmeztetés / blokkolás                  │
│  • Eszköztípus: opció / részvény / mind                         │
│  • Scope: pozíció / konto / portfólió                            │
├─────────────────────────────────────────────────────────────────┤
│                              ↓                                  │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐    │
│  │ Dashboard │  │ Figyelő-  │  │  Entry    │  │  Alert-   │    │
│  │  widget   │  │ lista jel │  │ ellenőrzés│  │  rendszer │    │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘    │
└─────────────────────────────────────────────────────────────────┘

A motor rendszeresen ellenőrzi az összes aktív szabályt, és teljesülés esetén kiváltja a megfelelő műveletet.

A kereskedési szabályok a platform különböző pontjain integrálva vannak:

Oldal	Integráció
Dashboard	"Teendő" widget aktív szabály-riasztásokkal
Pozíció-részletek	Az adott pozícióhoz tartozó aktív szabályok megjelenítése
Trade Entry	Ellenőrzés nyitás előtt (kockázati szabályok)
Figyelőlista	Jelzés-oszlop az entry-szabályok alapján
Értesítések	Push/e-mail, ha egy szabály kiváltódik
Kereskedési napló	Szabály-megfelelési pontszám trade-enként

A szabályokhoz a következő feltételtípusok állnak rendelkezésre:

Típus	Leírás	Eszköz
PROFIT_PCT	Nyereség %-ban	Mind
LOSS_PCT	Veszteség %-ban	Mind
DTE	Days to Expiration	Opciók
DELTA	Delta-érték	Opciók
IV_RANK	IV Rank/percentilis	Opciók
POSITION_SIZE_PCT	Pozíció > X% portfólió	Kockázat
BUYING_POWER_PCT	BP kihasználtság > X%	Kockázat
EARNINGS_DTE	Earnings X napon belül	Mind

⚠️ Megjegyzés: A kereskedési szabályok rendszere jelenleg a koncepciófázisban van. Az itt leírt funkciók a jövőbeli verziókban kerülnek megvalósításra.

A visszajelzésed szívesen fogadjuk, hogy a funkciókat optimálisan alakíthassuk ki! A részletes technikai dokumentációt a docs/concepts/TRADING-RULES.md fájlban találod.

Here is how to create your own individual rule:

┌─────────────────────────────────────────────────────────┐
│ ➕ New Rule                                              │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ Name: [My Stop-Loss Rule____________________]           │
│                                                         │
│ Scope:                                                  │
│ ○ 💼 Portfolio (all accounts)                          │
│ ● 🏦 Account: [Interactive Brokers ▼]                  │
│ ○ 🎯 Position: [Select position...]                    │
│                                                         │
│ When:                                                   │
│ [Loss %_____▼] [>=] [15__] [%]                         │
│                                                         │
│ Then:                                                   │
│ [🔔 Send Alert___▼]                                    │
│                                                         │
│ Asset Type: ○ All  ● Stocks  ○ Options                 │
│                                                         │
│              [Cancel]  [💾 Save]                       │
└─────────────────────────────────────────────────────────┘

You define: Name, Scope, Condition (When…), Action (Then…) and Asset Type.

On the dashboard you see all positions where a rule has been triggered:

┌─────────────────────────────────────────────────────────┐
│ ⚠️ Action Required (3)                                  │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ 🟡 AAPL 180 PUT         50% profit reached (52%)       │
│    Rule: 50% Profit Take                                │
│    [Close] [Ignore]                                     │
│                                                         │
│ 🔴 MSFT 400 CALL        21 DTE reached (18 days)       │
│    Rule: 21 DTE Management                              │
│    [Roll] [Close] [Ignore]                              │
│                                                         │
│ 🟡 TSLA Stock           Stop-loss nearly reached (-9%) │
│    Rule: 10% Stop-Loss                                  │
│    [Sell] [Adjust Stop] [Ignore]                        │
│                                                         │
└─────────────────────────────────────────────────────────┘

Each alert shows: Symbol, rule name, current value, and action buttons. The color (🟡 yellow, 🔴 red) indicates urgency.

In the detail view of a position you see which rules are active:

┌─────────────────────────────────────────────────────────┐
│ AAPL 180 PUT 2025-01-17                                 │
├─────────────────────────────────────────────────────────┤
│ ...Position Details...                                  │
│                                                         │
│ 📋 RULES FOR THIS POSITION                             │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✅ Portfolio: 50% Profit Take (active)             │ │
│ │ ✅ Portfolio: 21 DTE Management (active)           │ │
│ │ ➕ Add rule for this position...                    │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

You see all rules that apply to this position (portfolio-wide, account-wide, or position-specific). With ➕ you can directly create a new rule for this position.

The following condition types are available for rules:

Type	Description	Asset
PROFIT_PCT	Profit in %	All
LOSS_PCT	Loss in %	All
DTE	Days to Expiration	Options
DELTA	Delta value	Options
IV_RANK	IV Rank/Percentile	Options
POSITION_SIZE_PCT	Position > X% of portfolio	Risk
BUYING_POWER_PCT	BP Usage > X%	Risk
EARNINGS_DTE	Earnings in X days	All

For the technically curious: the system stores rules in three tables:

1. trading_rule_presets (System Presets)
Admin-defined rules that all users can enable.

2. user_trading_rules (User Rules)
Contains activated presets and custom rules for each user, with scope assignment.

3. trading_rule_triggers (Trigger Log)
Logs when which rule was triggered and how the user responded (closed, ignored, etc.).

This structure enables:
• Fast checking of all active rules
• Analysis of rule compliance over time
• Compliance reporting in the trade journal

For the popular Wheel Strategy there are special rules:

Rule	Description
Only Stocks You Want to Own	Only run the Wheel on stocks you would hold long-term
Cash-Secured	Always keep enough cash for assignment
CC at Resistance	Place Covered Calls at technical resistance
CC Not Below Cost Basis	Never sell Covered Calls below your purchase price

The Trading Rules system will be developed in phases:

Phase 1: Foundation
• Create database tables
• Define system presets
• Admin page for preset management

Phase 2: User Rules
• User rules UI
• Activation of system presets
• Create custom rules

Phase 3: Rule Engine
• Automatic checking of all rules
• Trigger detection
• Logging of all activations

Phase 4: Alerts & Notifications
• Dashboard widget "Action Required"
• Email notifications
• Push notifications (optional)

Phase 5: Integration
• Position detail: show active rules
• Trade entry: risk checks
• Trade journal: compliance analysis

We want to design the system optimally and welcome your feedback on these questions:

1. Auto-Execution: Should rules also be able to execute trades automatically (e.g., auto-close)?

2. Check Interval: How often should the rule engine run (real-time vs. every 5 min vs. hourly)?

3. Community Rules: Should rules be shareable between users?

4. Which Presets: Which rules should be included as system presets?

Send your feedback to the support team or in the forum!

Trading Lights is your market status dashboard in green/yellow/red. You'll find it on the dashboard and as a sidebar widget. It shows at a glance whether current market conditions are favorable for new trades.

What is displayed?
Three categories, each with its own traffic light (green/yellow/red):

• Macro Environment — Fear & Greed Index, VIX, and NYSE Market Breadth as a third indicator (see next section).
• Sector Context — your underlying's sector compared to the overall market (RSI, SMA200 status).
• Underlying Status — the specific market you're looking at (trend, volatility, recent movements).

Majority logic instead of "worst indicator wins": Each category summarizes its indicators by majority — if 2 of 3 are green, the category is green. This prevents a single red outlier from negating an entire category.

Clicking on a traffic light opens a modal with beginner-friendly explanations for each indicator — what the value means, how it compares historically, and what actions are suggested.

Market breadth measures whether a market move is driven by many stocks or just a few heavyweights. An S&P 500 rising because 7 mega-caps are up is less healthy than one rising because 400 stocks are up.

Singularity Trader automatically calculates four NYSE breadth indicators every 3 hours:

• A/D Ratio (Advance/Decline) — ratio of advancing to declining stocks on the NYSE. Values > 2.0 = broadly supported rally; < 0.5 = broad selloff.
• McClellan Oscillator — smoothed breadth momentum indicator. Positive = broad upward thrust, negative = broad downward thrust. Zero-line crossings are classic signals.
• NYSE > 50d MA — percentage of NYSE stocks above their 50-day average. > 70% = hot (risk of overheating), < 30% = cold (potential setup environment).
• High/Low Ratio — ratio of new 52-week highs to lows. Divergences from the index are often early warning signals.

Where you see this:
• In the Trading Lights modal as the third macro indicator
• In the Markets tab as its own metric row
• On the dashboard under "Market Context"
• As a detail heatmap on the market analysis page

In one sentence: Breadth green = "The market is carrying you"; breadth red = "You're swimming against the current".

The COT Report (Commitments of Traders) is published weekly by the CFTC and shows net positions of large institutional traders in futures markets. Singularity Trader imports this data automatically and presents it in structured form.

Why is this interesting?
If Commercial Hedgers (e.g., gold mines, oil companies) are rarely this long historically — it's often a signal they expect a bottom. If Large Speculators are extremely bullish, a trend reversal is often imminent.

What you'll find:
• Heatmap overview — all available futures markets (Gold, Oil, S&P, EUR, Bitcoin, …) with their current COT status
• COT Index (52 weeks) — normalized: 0% = extreme bearish, 100% = extreme bullish in 1-year history
• Detail view per market — historical charts of Commercial, Large Speculator, and Small Trader positions with price chart overlay
• Related instruments — e.g., Gold COT also shows Silver, Platinum, GLD ETF flows
• Signal labels — "Commercial Extreme Long" / "Speculator Extreme Short" etc., when a market hits its 5-year extreme

Data is updated every Friday evening (after CFTC release). Accessible via sidebar Market Analysis → COT.