Dokumentation

Risk-Engine & Webhook-Referenz

Wie AlgoVesta jedes Signal vor der Ausführung prüft und das exakte JSON-Payload, das von TradingView oder einer beliebigen Webhook-Quelle gesendet wird. Feldnamen sind wörtlich — kopiere sie unverändert.

AlgoVesta führt Trades aus drei Auslösekanälen aus: einem MCP-Server für KI-Assistenten, Telegram-Signalen und TradingView-Webhooks. Egal welcher Kanal auslöst — dieselbe serverseitige Risiko-Engine prüft die Order, bevor sie deine Börse oder dein MetaTrader-5-Konto erreicht. Diese Seite ist der technische Referenz-Hub für alle drei.

Drei Wege, einen Trade auszulösen

Jeder Kanal endet im selben Ausführungspfad: Prüfung, Positionsgrößenberechnung, Order und anschließend Stop-Loss sowie Take-Profit direkt an der Börse platziert. Wähle den Kanal, der zu deiner bestehenden Arbeitsweise passt.

MCP-Server für KI-Assistenten

Verbinde Claude, ChatGPT, Cursor oder jeden MCP-fähigen Client über einen authentifizierten Link mit zwanzig nativen Trading-Tools. Jede Verbindung startet mit einem Paper-Guthaben von 5.000 $, und Live-Keys werden separat mit einem zweiten Faktor erstellt. Die Authentifizierung erfolgt entweder über OAuth 2.1 mit PKCE (S256) oder über einen benutzerbezogenen Secret Link.

Telegram-Signalkanäle

Richte AlgoVesta auf die Signalkanäle aus, denen du bereits folgst. Nachrichten werden in Symbol, Richtung, Einstieg, Stop-Loss und Ziele zerlegt und dann auf deiner Börse ausgeführt oder an MetaTrader 5 weitergeleitet. Signale, die sich nicht eindeutig auswerten lassen, werden abgelehnt statt geraten.

TradingView-Webhooks

Sende einen Alarm von jedem Indikator, jeder Zeichnung oder Pine-Strategie an deine private Webhook-URL. Der Alarmtext muss gültiges JSON im unten dokumentierten Format sein, und die Quelle jedes automatisch gehandelten Signals wird geprüft, bevor eine Order eröffnet wird.

Risk-Engine: wie ein Signal geprüft wird

Ein Signal wird nie blind ausgeführt. Bevor eine Order platziert wird, durchläuft es eine mehrstufige Prüfschicht, die es gegen die Live-Marktbedingungen und deine Limits abgleicht. Fällt eine harte Regel, wird das Signal abgelehnt — nicht verkleinert.

Neuronales Scoringein Konfidenzwert von 0–100 aus einem Scoring-Modell.
Volumen & Order-FlowVolumenspitzen und aggressives Handelsungleichgewicht (VPIN).
MarktregimeKlassifizierung Trend vs. Range vs. Mean-Reversion.
Funding & LiquidationFunding-Rate-Dynamik und Liquidationscluster.
Stop-Loss-Mappingvermeidet Stops innerhalb bekannter Liquiditätscluster.
Deine harten RegelnRichtung, Handelszeiten, Positions- und Drawdown-Limits.

Der genaue Modulsatz und die Schwellenwerte entwickeln sich mit der Feinabstimmung der Plattform. Das Prinzip bleibt: deine Regeln und Risikolimits werden immer angewendet, bevor eine Order deine Börse erreicht.

Tagesverlust- & Drawdown-Schutz

Über die Prüfungen pro Signal hinaus laufen zwei Schutzmechanismen auf Kontoebene fortlaufend.

TagesverlustlimitWenn dein realisierter Tagesverlust dein konfiguriertes Limit erreicht — ein Prozentsatz des Guthabens oder ein fester Betrag — geht AlgoVesta in den Safe Mode und öffnet bis zum nächsten Tag keine neuen Trades.
Drawdown-basierte GrößeWenn der Konto-Drawdown wächst, wird die Positionsgröße stufenweise automatisch reduziert (vorsichtig → defensiv → Survival), sodass eine Verlustserie dein Risiko verringert statt es zu verstärken.

Webhook-Payload-Referenz

Sende einen HTTP-POST mit JSON-Body an deine AlgoVesta-Webhook-URL. In TradingView füge dies in das Alarm-Nachrichtenfeld ein. Feldnamen müssen exakt übereinstimmen.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
FeldErforderlichBeschreibung
symbolJaHandelspaar der Börse, z. B. BTCUSDT.
side / actionJaOrderrichtung: buy oder sell.
priceOptionalEinstiegs-Referenzpreis; für Market-Einstieg weglassen.
stop_lossOptionalStop-Loss-Preis. Bei jedem Signal empfohlen.
take_profitOptionalTake-Profit-Preis. Mehrere Ziele in der App konfigurierbar.
marketOptionalZielmarkt: crypto (Standard) oder forex. Wird bei forex an MetaTrader 5 gesendet. Wird niemals aus dem Symbol abgeleitet.
lotsOptionalNur Forex — Positionsgröße in Lots. Leer lassen, um deinen konfigurierten Lot-/Risikomodus zu verwenden.
leverageOptionalNur Krypto — es gilt das Limit Ihrer Börse für dieses Symbol.
amount_usdOptionalNur Krypto — Margin, nicht der Nominalwert. Nominalwert = Margin × Hebel.
risk_percentOptionalNur Krypto — zu riskierender Prozentsatz des Guthabens (0,1–50).
quantityOptionalNur Krypto — exakte Kontraktmenge. qty, size und contracts werden als Aliase akzeptiert.
take_profitsOptionalMehrere Ziele: [{"price":…, "close_pct":…}]. tp1tp5 mit tpN_close funktioniert ebenfalls.
trailingOptional{"trigger_pct":…, "distance_pct":…} — nachlaufender Stop (Trailing Stop).
breakevenOptionaltrue oder {"trigger_pct":…} — verschiebt den Stop bei Gewinn auf den Einstiegspreis.

Börsen-Präfixe werden entfernt, daher funktioniert BINANCE:BTCUSDT genauso wie BTCUSDT. Beim Richtungsfeld werden direction und type als Aliase von action akzeptiert, und close ist ein gültiger Wert.

Positionsgröße, Hebel und Risiko pro Signal können aus deinem Dashboard oder aus dem Payload stammen — ein Wert im Payload hat Vorrang. Deshalb ist die Webhook-URL ein Geheimnis: Füge eine IP-Zulassungsliste hinzu, damit AlgoVesta nur Signale automatisch handelt, deren Quelle verifiziert werden kann.

Eine Position schließen

Sende "action": "close" zusammen mit dem Symbol. Die gesamte Position in diesem Symbol wird geschlossen — Teilschließungen werden nicht unterstützt; forderst du eine an, wird die gesamte Position geschlossen, und das Panel weist darauf hin.

{ "symbol": "BTCUSDT", "action": "close" }

Pine-Strategie-Alerts — Exits erfolgen automatisch

Wenn du den Alert aus einer Pine-strategy() mit “Order fills only” erstellst, sende action nicht allein: {{strategy.order.action}} gibt auch bei einem Exit sell zurück, was statt einer Schließung eine Short-Position eröffnen würde. Füge die Positionsstatus-Felder hinzu, dann ermittelt AlgoVesta Entry, Exit und Reversal für dich.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
Position nach der AusführungWas AlgoVesta tut
flat (or position_size = 0)Schließt die Position. Es wird keine Gegenorder eröffnet.
Gegenteil des vorherigen ZustandsReversal — schließt zuerst, dann eröffnet es die neue Richtung. Schlägt das Schließen fehl, wird nichts eröffnet.
Gleiche Richtung wie zuvorWird als Einstieg in diese Richtung behandelt.

Die Nachricht muss JSON sein. TradingView sendet den Alert-Text als reinen Text, wenn er kein gültiges JSON ist — seine Standardnachricht (z. B. “BTCUSDT Crossing 1.00”) enthält keine Richtungsangabe und wird abgelehnt. Wir raten bei mehrdeutigem Text niemals; ein Signal abzulehnen ist sicherer, als eine Order in die falsche Richtung zu eröffnen. Beachte außerdem, dass TradingView Alerts automatisch stoppt, nachdem sie innerhalb von 3 Minuten 15-mal ausgelöst wurden.

No-Code-Builder
Kein JSON von Hand — baue es visuell

Lege Richtung, Take-Profit / Stop-Loss (einzeln oder mehrstufig), Hebel, Positionsgröße, Trailing und Breakeven per einfacher Schalter fest. AlgoVesta erzeugt die exakte TradingView-Alarmnachricht — kopieren und in deinen Alarm einfügen.

So funktioniert der visuelle Builder → Schritt-für-Schritt-Alarm-Einrichtung →

Häufig gestellte Fragen

Welche Kanäle können bei AlgoVesta einen Trade auslösen?

Drei: der MCP-Server für KI-Assistenten, Telegram-Signalkanäle und TradingView-Webhooks. Ein Trade kann auch manuell über dein Dashboard eröffnet werden. Jeder Kanal läuft über denselben Ausführungspfad und dieselben Risikoprüfungen.

Ist das Webhook-JSON-Format für TradingView erforderlich?

Ja. TradingView sendet den Alarmtext als reinen Text, wenn er kein gültiges JSON ist, und die Standard-Alarmnachricht enthält keine Richtung, weshalb sie abgelehnt wird. Verwende das oben dokumentierte Payload-Format in der Webhook-Payload-Referenz oder erstelle es visuell und füge das Ergebnis in deinen Alarm ein.

Gilt die Risiko-Engine auch für MCP- und Telegram-Orders?

Ja — auf jedem Kanal laufen dieselben serverseitigen Prüfungen. Deine Risikorichtlinie, die Stop-Loss-Pflicht sowie deine Positions- und Drawdown-Limits werden durchgesetzt, bevor eine Order eine Börse erreicht — egal ob sie von einem KI-Assistenten, einem Telegram-Signal oder einem TradingView-Alarm stammt. Kein Prompt und keine Nachricht kann sie lockern.

Wo finde ich die vollständige MCP-Tool-Referenz?

Die MCP-Entwicklerreferenz dokumentiert alle 20 Tools, die drei Scopes, die OAuth-2.1- und Secret-Link-Authentifizierung, Rate Limits, Fehlercodes sowie die 16 unterstützten Börsen plus MetaTrader 5.

Kann ich ohne echtes Geld testen?

Ja. Jede MCP-Verbindung startet mit einem virtuellen Paper-Guthaben von 5.000 $ zu echten Marktpreisen, und sowohl die TradingView- als auch die Telegram-Automatisierung verfügen über einen Demomodus, der den gesamten Ablauf vom Signal bis zur Order simuliert. Für den Live-Handel ist immer ein separater, ausdrücklich erstellter Key oder eine separate Verbindung erforderlich.