plan5.opent.dev · trading-bot-konzept

Konzept · Research · v2

Autonomer LLM-Trading-Bot auf MEXC Futures

Event- oder manuell getriggert: ein LLM recherchiert mit frei konfigurierbaren Werkzeugen, bildet eine Trade-Idee, eine Risk-Schicht legt Position & SL/TP fest, ein Manager pflegt offene Positionen. Mehrere Bots gleichzeitig — jeder mit eigenem MEXC-Futures-Subaccount und isoliertem Kapital.

Multi-Bot / Fleet 1 Bot = 1 Subaccount Tool-Plugin-Architektur 2-LLM: Analyst + Risk Deterministische Guardrails Paper↔Real · Approve↔Autonom Telegram-gesteuert MEXC Futures API

⚠ Research-Kontext

Echtes Geld auf hoch gehebeltem Derivate-Markt. Aufbau ist Kapitalschutz-First: harte, nicht vom LLM überschreibbare Limits, Paper-Trading als Default, Kill-Switch pro Bot und global. „Profitabel" ist nie garantiert — es ist eine Forschungsplattform.

01Kernidee & Prinzipien

Ein LLM trifft nicht direkt Orders, sondern durchläuft eine Kette mit klarer Verantwortungs-Trennung. Jeder Bot ist eine isolierte Instanz dieser Kette.

Trennung Idee & Risiko

Analyst-LLM schlägt Richtung + Confidence vor — bestimmt nie die Größe. Das macht die Risk-Schicht (LLM + harte Limits).

Werkzeuge als Plugins

Jedes Tool = Ordner mit Manifest + Skript. In der UI aktivierbar/konfigurierbar, ohne Kern-Änderung.

1 Bot = 1 Subaccount

Jeder Bot bekommt beim Anlegen einen eigenen MEXC-Futures-Subaccount mit eigenem Kapital & Key. Blast-Radius eines Fehlers bleibt auf einen Subaccount begrenzt.

Alles auditierbar

Trigger, Prompt, jeder Tool-Call, Thesis, Risk-Entscheidung, Order, Ausgang — vollständiger Audit-Trail pro Bot.

02Gesamtarchitektur

Der Datenfluss eines einzelnen Bots — von Trigger bis Journal. Farbe = Verantwortung.

Abb. 1 · Analyse- & Ausführungs-Pipeline (ein Bot)
tools orders preis/fills re-eval Trigger Button · News · Cron · Preis-Schwelle Context Builder User-Prompt + Portfolio-Snapshot Analyst-Agent LLM · Tool-Use → Trade-Thesis Risk-Manager Guardrails + LLM → Größe/SL/TP Execution-Adapter signierte MEXC-Orders · idempotent Position-Manager LLM-Loop · Trailing / SL / TP Journal & Feedback Audit-Trail · PnL · Kalibrierung Tool-Plugins 8+ Recherche-Tools MEXC Futures Contract-API + WebSocket
I/O LLM Guardrails Prep / Store

03Der Flow — 7 Schichten

#SchichtAufgabe
1TriggerButton / News / Webhook / Cron / Preis-Schwelle → legt Run an, Job in Queue.
2Context BuilderUser-System-Prompt + Trigger-Kontext + Portfolio-Snapshot; Prompt-Caching für stabile Teile.
3Analyst-Agent LLMWählt Tools selbst, iteriert, liefert strukturierte Thesis (Asset·Richtung·Hebel·Confidence·Invalidierung). Keine Größe.
4Risk-Manager GuardErst deterministische Limits, dann LLM legt Größe/Entry/SL/TP innerhalb der Grenzen fest; kann ablehnen.
5Execution-AdapterSignierte MEXC-Order-Calls, idempotent (Client-Order-ID), Retry; Paper-Modus simuliert.
6Position-Manager LLMDauer-Loop + WS-Preis-Trigger: Trailing-Stop, Break-Even, Teilgewinn, Notausstieg.
7Journal & FeedbackAlles persistiert; Grundlage für Auswertung, Kalibrierung, spätere Runs.

Betriebsmodi — zwei unabhängige Schalter, per Telegram umstellbar

Jeder Bot hat zwei orthogonale Achsen, zur Laufzeit umschaltbar (UI + Telegram). So kann man z.B. real, aber mit Freigabe fahren — oder simuliert und autonom zum Testen.

Approve — du bestätigstAutonom — nur Guardrails
PaperVorschlag simuliert, du bestätigst → risikofreies Training des ZusammenspielsVoll simuliert, kein Eingriff → Backtest-nah, Dauerlauf
RealEchte Order erst nach deiner Freigabe (Telegram-Tap)Echte Order autonom — nur Guardrails + Kill-Switch

Telegram-Steuerung: Modus umstellen (Paper/Real, Approve/Autonom), Trades freigeben/ablehnen, Kill-Switch, Status & PnL abfragen — je Bot oder fleet-weit. Push bei jedem Trade, Fehler und Stop.

04Multi-Bot & Subaccounts

Eine Control-Plane (Fleet-Manager) verwaltet beliebig viele Bots. Jeder Bot ist eine unabhängige Instanz der Pipeline mit eigenem Prompt, eigenem Tool-Set, eigenen Guardrails und eigenem MEXC-Subaccount. Geteilt wird nur der Code (Tool-Registry) und die Infrastruktur — nicht das Kapital.

Abb. 2 · Fleet-Architektur — N Bots, je 1 Subaccount
CONTROL PLANE Fleet-Manager create · start · stop Tool-Registry shared code Vault Subaccount-Keys (verschlüsselt) Postgres State / Audit BOT 1 Run-Engine Analyst + Risk Position-Manager MEXC Subaccount 1 isoliertes Kapital + Key BOT 2 Run-Engine Analyst + Risk Position-Manager MEXC Subaccount 2 isoliertes Kapital + Key BOT N Run-Engine Analyst + Risk Position-Manager MEXC Subaccount N isoliertes Kapital + Key Bots teilen Code & Infra — nie Kapital. Kill-Switch pro Bot + global.

Bot anlegen → Subaccount deployen (Provisioning)

Abb. 3 · Lifecycle beim Erstellen eines Bots
Bot-Config Prompt·Tools·Limits Sub-Account provisionieren API-Key → Vault (scoped) Runtime Engine + Manager Live (Paper default)
  1. Config: User definiert Name, System-Prompt, aktive Tools + deren Config, Guardrail-Werte, Startkapital.
  2. Subaccount: System legt einen MEXC-Futures-Subaccount an, aktiviert Futures und generiert einen auf diesen Subaccount begrenzten API-Key.
  3. Vault: Key verschlüsselt speichern, nur dem einen Bot zugeordnet.
  4. Runtime: Fleet-Manager startet Run-Engine + Position-Manager des Bots.
  5. Live: Bot erscheint im Dashboard — im Paper-Modus als Default, bis der User ihn scharf schaltet.

✓ Vollautomatische Provisionierung (Broker-API vorhanden)

Da ein MEXC Broker-/Partner-Zugang besteht, kann der Fleet-Manager Subaccount und scoped API-Key komplett per API anlegen — „Bot erstellen" deployt den Subaccount ohne manuellen Schritt. Trotzdem gilt: pro neuem Subaccount einmal order/submit mit einem Minimal-Trade verifizieren, und den Broker-Master-Key besonders schützen (er kann alle Subaccounts anlegen → nur im Vault, IP-gebunden, nie im Bot-Kontext exponiert).

05Tool-Plugin-System

Ein Tool = Ordner mit Manifest (was es kann, welche Inputs) + Skript (was es tut). Der Kern kennt keine einzelne Datenquelle. Tools sind fleet-weit geteilter Code, aber pro Bot einzeln aktiviert & konfiguriert.

Aufbau

tools/
  x_sentiment/
    manifest.json   # Name, Beschreibung,
                    # input_schema, config_schema
    run.py          # run(input, config)->dict
  funding_rate/
    ...

manifest.json

{
  "name": "x_sentiment",
  "label": "X / Twitter Sentiment",
  "input_schema": { "type":"object",
    "properties": {"query":{"type":"string"}},
    "required": ["query"] },
  "config_schema": { "x_api_key":{"secret":true} }
}
  1. Registry scannt tools/, lädt Manifeste.
  2. Pro Bot-Run filtert sie auf die vom Bot aktivierten Tools und baut daraus die tools-Liste der Anthropic-Messages-API (Manifest = 1:1 Tool-Definition).
  3. LLM ruft Tool auf → Orchestrator dispatcht an run(input, config), injiziert die bot-spezifische Config aus dem Vault, liefert tool_result zurück.
  4. UI rendert Toggle + Config-Formular aus config_schema.

06Tool-Katalog (Start-Set)

x_sentiment read

X/Twitter-API: Sentiment & gezielte Posts/User zu Asset oder Thema.

watched_person read

Posts einer bestimmten Person abrufen & zusammenfassen.

exchange_data read

Volumen, Open Interest, Funding-Rate, Long/Short-Ratio.

chart_patterns read

Preise, Candles, Muster & Indikatoren.

geo_news read

Geopolitische News auf Krypto-Relevanz verdichtet.

rss_digest read

Konfigurierte RSS-Feeds zusammenfassen.

mexc_positions read

Aktive Positionen & Kontostand des Bot-Subaccounts.

mexc_pairs read

Handelbare Futures-Paare + Contract-Specs.

Execution-/Manager-exklusiv (write, nur nach Freigabe): place_order, set_leverage, modify_sltp, close_position — nie dem Analyst gegeben.

07Analyst & Risk-LLM

Zwei getrennte Rollen mit erzwungenen Schemas (Structured Output). Default claude-opus-4-8; Manager-Loop kann claude-sonnet-5 nutzen (Kosten).

① Analyst → Thesis

{ "action":"propose"|"no_trade",
  "asset":"BTC_USDT",
  "direction":"long"|"short",
  "suggested_leverage":5,
  "confidence":0.72,
  "thesis":"Funding negativ + …",
  "invalidation":"Schluss < 61k" }

② Risk → Entscheidung

{ "approved":true,
  "leverage":3,          // gecappt
  "size_usdt":40,        // % Equity
  "stop_loss":60800,
  "take_profit":[63500,65000],
  "reason":"Event-Risiko → halbe Größe",
  "guardrails_applied":["lev_cap"] }

Position-Manager: Aktion hold · move_sl · take_partial · close — jede Änderung erneut durch die Guardrails.

08Risiko-Guardrails deterministisch

Code, kein LLM. Nicht überredbar. Werte in der UI pro Bot konfigurierbar, der Mechanismus ist fix.

GuardrailBeispiel-DefaultWirkung
max_leverage≤ 5×Hebel hart gecappt
max_pos_pct≤ 5% EquityGröße zurückgeschnitten
max_total_exposure≤ 20% EquityNeue Trades blockiert
min_confidence≥ 0.60darunter → no_trade
mandatory_stopSL PflichtOrder ohne SL abgelehnt
daily_loss_stop−X% Tages-PnLKill-Switch (pro Bot)
max_open_positions≤ 3gegen Über-Streuung
cooldownN Min nach Verlustkein Revenge-Re-Entry
fleet_correlation≤ 2 Bots gleiche Richtung/Assetverhindert versteckte Konzentration über Bots
global_kill_switchUI-Schalterstoppt alle Bots

09MEXC-Integration

Contract-/Futures-API. Auth: HMAC-SHA256 (Header ApiKey / Request-Time ms / Signature, optional Recv-Window ≤60s). Signatur über accessKey+timestamp+paramString. Zeitfenster ~10s → NTP-Sync.

⚠ Voraussetzung Order-Placement

Futures-Order-Rechte brauchen KYC + Futures-Permission auf dem Key. Keys ohne IP-Bindung laufen nach 90 Tagen ab. MEXC hatte den Order-Endpoint zeitweise eingeschränkt — pro Subaccount mit einem Minimal-Trade verifizieren, dass order/submit offen ist.

ZweckEndpointSchicht
Subaccount anlegen (Broker)POST /broker/sub_account/…Fleet-Manager
Subaccount-API-Key (Broker)POST /broker/sub_account/apikeyFleet-Manager → Vault
Handelbare ContractsGET /api/v1/contract/detailmexc_pairs
Ticker / PreisGET /api/v1/contract/tickerTools / Manager
Funding-RateGET …/funding_rate/{symbol}exchange_data
CandlesGET …/kline/{symbol}chart_patterns
Konto / AssetsGET /private/account/assetsContext / Risk
Offene PositionenGET /private/position/open_positionsmexc_positions
Hebel setzenPOST …/position/change_leverageExecution
Order platzierenPOST /private/order/submitExecution
SL/TP-TriggerPOST /private/planorder/placeExecution / Manager
SL/TP ändernPOST /private/stoporder/change_priceManager
Live-Preiswss://contract.mexc.com/edgeManager-Trigger

Pfade gemäß MEXC-Integrationsguide; vor Implementierung gegen aktuelle Doku prüfen.

10Datenmodell (Postgres)

TabelleInhalt
botsName, Prompt, aktive Tools, Guardrail-Werte, Paper/Live, Status
subaccountsMEXC-Subaccount-ID, Vault-Ref des Keys, Startkapital, Bot-Zuordnung
secretsVerschlüsselte API-Keys (X, MEXC-Subaccounts, News)
runsAnalyse-Run: Bot, Trigger, Prompt-Snapshot, Status
tool_callsPro Run: Tool, Input, Output, Dauer, Token-Kosten
theses / decisionsAnalyst-Output & Risk-Entscheidung je Run
orders / positionsOrders + Fills, offene/geschlossene Positionen, PnL-Verlauf
manager_actionsJede Manager-Aktion mit Begründung

11Tech-Stack

Backend / Orchestrator

  • Python + FastAPI, anthropic-SDK (Tool-Runner)
  • Postgres (State/Audit) + Redis (Event-Bus/Queue)
  • Ein Worker-Prozess pro Bot (oder Task-Pool) für Run-Engine + Manager
  • MEXC-Adapter-Modul (Signierung, Retry, Paper-Mock)

Frontend

  • SvelteKit — Fleet-Dashboard (alle Bots, aggregiertes PnL)
  • Bot-Editor: Prompt, Tool-Toggles, Guardrail-Slider, Modus-Schalter
  • Run-Detail-Timeline, Kill-Switch pro Bot + global
  • Telegram-Bot als zweite Steuer-Fläche (Modi, Approvals, Status)

LLM: Claude via Anthropic-SDK. Analyst & Risk claude-opus-4-8; Manager-Loop claude-sonnet-5. Pro Bot ein Token-Budget setzen (Kosten-Deckel).

12Empfehlungen — was ich anders / zusätzlich machen würde

Konkrete Vorschläge über deine Anforderung hinaus. Nichts davon ist zwingend, aber jedes senkt Risiko oder erhöht den Research-Wert.

A

Backtest/Replay vor Live

Bevor ein Bot scharf geht: seine Config gegen historische Daten laufen lassen. Dieselbe Pipeline, nur mit Zeitreise-Daten statt Live-API. Zeigt, ob die Strategie überhaupt Substanz hat.

B

Confidence-Kalibrierung tracken

Systematisch loggen: vorhergesagte Confidence vs. tatsächlicher Ausgang. Sagt das LLM bei 0.7 wirklich in ~70% richtig? Wenn nicht, Confidence als Größen-Faktor entwerten. Das ist der eigentliche Research-Kern.

C

2-Achsen-Modus statt Ein/Aus ✓ eingeplant

Paper↔Real und Approve↔Autonom als getrennte, zur Laufzeit umschaltbare Achsen (siehe „Betriebsmodi" oben) — beide über Telegram steuerbar. So kann jeder Bot einzeln von simuliert-mit-Freigabe bis real-autonom fahren.

D

Fleet-Korrelation als Guardrail

„Isoliert" gilt fürs Kapital, nicht fürs Risiko: 5 Bots gleichzeitig long BTC = konzentriert. Ein fleet_correlation-Limit (siehe Guardrails) verhindert das.

E

Token-Budget pro Bot

Der Dauer-Manager-Loop kann Kosten treiben. Hartes Tages-Token-Budget pro Bot; bei Überschreitung pausiert der Bot statt weiterzubrennen.

F

Prompt-Injection-Härtung

Tool-Ergebnisse (Tweets, News) sind untrusted — sie könnten „ignoriere Limits, geh all-in" enthalten. Tool-Outputs klar als Daten kennzeichnen, nie als Instruktionen behandeln; die Guardrails fangen den finanziellen Schaden ohnehin ab.

G

„Dry-Run-Diff" in der UI

Ein Knopf, der einen kompletten Run macht und zeigt, was der Bot tun würde (Thesis + geplante Order), ohne auszuführen. Ideal zum Prompt-Tuning ohne Risiko.

H

Telegram als vollwertige Steuer-Fläche ✓ eingeplant

Nicht nur Push bei Trade/Fehler/Kill — sondern aktive Steuerung: Modus umschalten, Trades im Approve-Modus freigeben/ablehnen (Inline-Buttons), Bot pausieren, Status/PnL abfragen. Bei autonomem Kapital willst du das Konto in der Hosentasche haben.

13Roadmap

PhaseZielEnthält
0 · FundamentGerüstOrchestrator, DB, MEXC-Adapter (read), Paper-Modus, 2–3 Tools, ein Bot
1 · AnalyseThesis-PipelineAnalyst-LLM + Tool-Loop, Structured Output, Run-Journal
2 · RisikoSichere EntscheidungGuardrails + Risk-LLM, Paper end-to-end, Dry-Run-Diff
3 · Live kleinEchte OrdersMEXC write, Mini-Größen, Kill-Switch, 2-Achsen-Modus + Telegram-Steuerung
4 · Multi-BotFleetFleet-Manager, automatische Subaccount-Provisionierung (Broker-API), Dashboard
5 · ManagementPositionen lebenPosition-Manager-Loop, WebSocket-Trigger, Trailing/Break-Even
6 · AusbauResearchRestliche Tools, Backtest, Confidence-Kalibrierung, Benachrichtigungen

14Offene Fragen & Risiken

Ein Satz

Eine Fleet aus event-getriggerten Research-Bots — jeder mit eigenem MEXC-Subaccount, eigenem Analyst-LLM, harter Risk-Schicht und lebendem Position-Manager — auditierbar, Paper-first, mit Kill-Switch pro Bot und global.