🤖 AI-Agent Plannen

Orchestrator — single-agent autonoom

Eén Python script (orchestrator.py) dat alle taken combineert:

• Data ophalen via IBKR (met fallback durations)
• Indicatoren berekenen (SMA200, RSI14, ATR14)
• Entry-check: prijs > MA200 + RSI < 30
• Risk management (2% per trade, 5% drawdown cap)
• Order placement: MarketOrder BUY + StopOrder (paper)
• Exit management: stop-loss, 60-bar time cap, trailing stop, Friday breakeven
• Cooldown: 12 bars na exit

Draait 6× per dag via cron (03:05–23:05 NL, ma-vr) als no_agent watchdog. Model: deepseek-v4-flash.

📈 Zelflerend — wekelijkse WFA (zondag)

Elke zondag 08:00 NL draait een Walk-Forward Analysis via cron 45f0050b1328. Deze backtest de strategie over de nieuwste data en rapporteert:

• Out-of-sample rendement, Sharpe ratio, winrate
• Verslechtering t.o.v. baseline (OOS +5,30%, WR 37,5%, PF 1,61)

Bij verslechtering beslist Hugo over parameter-aanpassing (SMA window, RSI drempel, ATR multipliers). Volledig geautomatiseerde parameter-tuning (optie B) is een toekomstige stap — voor nu is de feedback-loop: WFA → Hugo → aanpassing.

Koppelingen & Infrastructuur

• Locatie: Hostinger VPS (Docker-omgeving)
• Netwerk: Tailscale VPN (geen publieke poorten)
• IB Gateway: Container ghcr.io/gnzsnz/ib-gateway — actief 🟢 verbonden
• Account: DUQ630468 (Paper Trading) · ~€1M NetLiq

🔌 IB Gateway — verbinding (Tailscale)

Hermes-container verbindt via Tailscale IP — geen Docker bridge of NAT nodig.

# Handmatige noodpatch (als watchdog nog niet gedraaid heeft):
docker exec ib-gateway sed -i '/^\[IBGateway\]/,/^\[/ s/^TrustedIPs=.*/TrustedIPs=127.0.0.1,172.16.0.1,172.16.0.2,172.16.0.3,172.16.1.1,172.16.1.2/' /home/ibgateway/Jts/jts.ini

Componenten & lijn

🌐 Hostinger VPS (srv1659405)
 └── 🐳 Docker
      ├── ib-gateway (gnzsnz/ib-gateway)
      │    └── Poort 4004 (Paper) via socat relay → intern 4002
      └── hermes-agent
           ├── 📊 Forex orchestrator.py (6× per dag, ma-vr)
           ├── ⏰ healthcheck_hourly (elk uur, stille poortcheck)
           ├── ⏰ forex rapport (21:10 UTC, dagelijks)
           └── 📱 Telegram → Hugo
    

Afhankelijkheidsvolgorde

1. VPS staat aan — Hostinger infrastructuur
2. Docker draait
3. Tailscale is up (100.108.36.111)
4. ib-gateway container — poort 4004 open
5. hermes-agent container — draait crons
6. Orchestrator (6× per dag op 4H candles) — verbindt met IB
7. Telegram alert — naar Hugo (alleen bij trade/error)

⚠️ Eén haperende schakel = hele keten stil.

4H schema (ma-vr)

✅ Monitoring: 4 lagen — poort (elk uur), data pipeline (elk uur :20), trade watchdog (6×/dag), dagelijks rapport (21:10 UTC). Stil bij normaal, melding bij elk probleem.

Wekelijks schema (zondag)

Referentiewaarden (live 24 jun 2026): OOS +5,30% · 14 trades/jr · WR 37,5% · PF 1,61. Bij verslechtering ⚠️ — Hugo beslist over aanpassing (optie A, geen auto-aanpassing).

IB Gateway offline

Symptoom: Poort 4004 onbereikbaar. Telegram alert "IB Gateway Offline".

Oplossing — SSH naar VPS:

docker start ib-gateway
timeout 3 bash -c "echo >/dev/tcp/100.108.36.111/4004" && echo "OPEN" || echo "DICHT"

Bij twijfel: docker logs ib-gateway --tail 20

Hele stack herstarten

Bij VPS-reboot of container-crash — één commando op de VPS:

bash /root/redeploy_ib_gateway.sh

Start de gateway opnieuw met correct volume + poortmapping, wacht op IBC login, patcht TrustedIPs. Hermes-crons draaien daarna automatisch door.

Hostkey gewijzigd (SSH weigert)

ssh-keygen -R srv1659405
ssh-keygen -R 100.108.36.111

Error 162 — "connected from a different IP address"

Symptoom: Account info werkt via poort 4004, maar reqHistoricalData retourneert 0 bars met stille Error 162 in de TWS logs.

Oorzaak 1 — TrustedIPs: De IB Gateway Java-applicatie overschrijft [IBGateway] in jts.ini bij elke login — volume en template-patch hebben geen effect.

Oorzaak 2 — IBKR live sessie (ontdekt 29 jun 2026): Als je ergens anders bent ingelogd op IBKR (telefoon-app, desktop TWS), vergrendelt dat de marktdata voor andere sessies. De error is exact hetzelfde als TrustedIPs — je ziet het verschil alleen aan de gateway-logs.

Fix Oorzaak 2: Log uit bij IBKR op alle apparaten → Client Portal → Uitloggen → daarna gateway herstarten.

Permanente oplossing: socat (poort 4004) forwardt naar 127.0.0.1:4002 — TrustedIPs is altijd correct mits API_PORT=4002 en SOCAT_PORT=4004 env-vars in de container staan.

Herdeployment (bij VPS-reboot of container-crash):

bash /root/redeploy_ib_gateway.sh

Dit script op de VPS: stop/rm oude container → start nieuw met volume + alle 4 poorten (4004:4004) + -e API_PORT=4002 -e SOCAT_PORT=4004 → wacht 90s op IBC login.

Orchestrator fallback — "Insufficient data points"

Symptoom: De dagelijkse cron-run toont "Insufficient data points" ondanks dat de gateway online is (poort 4004 open).

Oorzaken (twee mogelijk):

• Paper account reset (~00:00-01:00 UTC): IBKR wist de paper account data. De orchestrator probeert 250 D → 100 D → 50 D → 30 D met dalende drempels (200 → 80 → 40 → 20 bars). Als een kortere duration wél data oplevert, gebruikt de orchestrator die met een dynamische SMA window.
• Error 162 / TrustedIPs: Alle durations retourneren 0 bars — zie de sectie hierboven.

Fix toegepast 23 jun 2026 in /opt/data/orchestrator.py — DataPipeline.get_market_data() probeert 4 durations met fallback, en past de SMA window dynamisch aan op basis van beschikbare bars.

Basislijn vastgelegd vóór eerste live paper trade. Hier meten we wekelijks tegenaan.

Strategie

Backtest baseline

Infrastructuur

Evaluatie-momenten

4H candles — timing

EUR/USD 4H candles sluiten op UTC: 01:00, 05:00, 09:00, 13:00, 17:00, 21:00. De orchestrator draait op :05 na elke close om de net afgesloten candle te analyseren.

• 21:00 UTC candle — valt binnen IBKR maintenance (~21:00–21:30 UTC). Datafallback in get_market_data() vangt dit op via kortere durations.
• Paper account reset (~00:00–01:00 UTC) — tijdelijk minder historische data beschikbaar. Fallback 250D→100D→50D→30D met dalende minimumdrempels.

Signalen worden direct na candle-close berekend en uitgevoerd. Geen vertraging — market order op de eerstvolgende beschikbare prijs.

De watchdog stuurt alleen een bericht bij een relevante event: trade geplaatst, fout, timeout of trade geblokkeerd. Geen melding = passief, alles normaal.

1. Passief rapport — standaard status

Het systeem functioneert correct, maar de markt voldoet niet aan de twee instapeisen (prijs > MA200 én RSI < 30). Geen actie vereist.

2. Goedgekeurd signaal — AUTO-TRADE

Alle condities ✅ + cooldown verstreken + risk goedgekeurd → orchestrator plaatst automatisch een market buy + stop-loss op paper account. Geen handmatige actie nodig. Het rapport dat je ontvangt is een bevestiging, geen vraag om toestemming.

3. Geblokkeerd risico-rapport — noodrem actief

Een signaal was aanwezig, maar de RiskManager heeft ingegrepen. Dit treedt op in twee scenario's:

• De verbinding met de accountsummary kon niet worden geverifieerd
• De circuit breaker is geactiveerd: virtuele drawdown ≥ 5% t.o.v. de High-Water Mark in trading_state.json

4. Cooldown — 48 uur pauze na stop-out

Na een stop-out (of handmatige sluiting) start een 12-bar cooldown (48 uur). De orchestrator detecteert de exit door had_position in trading_state.json te vergelijken met de huidige positie. Zelfs als condities meteen weer ✅ zijn, wordt er pas na 48 uur weer een entry overwogen. Voorkomt whipsaw na stop-loss.