Die Börse, die dein Bot sich leisten kann, kaputtzumachen.

Endpunkte

Vierundzwanzig davon. Alles ist JSON über HTTPS, CORS an, ein Header. Ersetze v1 in jedem Pfad durch v2, um das {ok,data,ts}-Envelope zu bekommen.

bars = get(f"/api/bot/v1/klines?symbol=BTC&interval=1")
while len(all_bars) < wanted:
    end_ms = bars[0]["time"] * 1000          # oldest candle in hand
    bars = get(f"/api/bot/v1/klines?symbol=BTC&interval=1&end={end_ms}")
    if not bars: break
    all_bars = bars + all_bars

Maschinenlesbar: die OpenAPI-3.1-Spezifikation mit vollständigen Request- und Response-Schemas · eine interaktive Referenz, aus der du Aufrufe abfeuern kannst · der Changelog (JSON).

Wie die Engine funktioniert

Fill-Realismus, denn ein Backtest, der dir schmeichelt, ist nichts wert

Zwei Dinge in dieser Engine sind bewusst großzügig, und es ist besser, sie zu benennen, als dich auf einem Live-Konto darauf stoßen zu lassen. Eine Market-Order wird zum Live-Preis ausgeführt, sodass eine neue Position 0.00 unrealisiert zeigt und die Entry-Linie genau dort liegt, wo du sie wolltest. Und die Maintenance Margin ist pauschal 0.5%, egal was die Position wert ist. Zum Lernen des Tradings ist beides richtig. Um eine Strategie zu beweisen, sind sie optimistisch, und je größer die Größe, desto optimistischer.

Es sind also Schalter, keine Annahmen. Standardmäßig aus - nichts, was du schon gebaut hast, verschiebt sich - und eingeschaltet verhalten sich Ausführungspreis und Liquidationspreis so, wie ein echtes Book und eine echte Risk-Limit-Tabelle sie sich verhalten lassen.

GET  /api/bot/v2/realism                     // your setting, the venue table and the whole tier ladder
POST /api/bot/v2/realism {"slippage": true, "margin_tiers": true, "margin_venue": "binance"}

# or per call, so one strategy can be tested both ways without touching the account
POST /api/bot/v1/open {"symbol":"BTC","side":"long","margin_usd":100,"leverage":10,
                       "slippage": true, "margin_tiers": true, "mmr_pct": 0.4}

Diese drei sind nur ein Teil. Die gesamte Simulation ist konfigurierbar - Größe des Buchs und ob es ein echtes Budget ist, deine eigenen Slippage- und Gebührenwerte, Größeneffekt, Latenz, Teilausführungen, Ablehnungen und Funding - und acht Presets setzen sie in einem Aufruf. Eine Position behält die Maintenance Margin, mit der sie ausgeführt wurde, daher überschreibt das Einschalten nie einen Trade, den du schon hältst, und jeder Close hält fest, womit er lief. Daher hat die Arena ihre Spalte Fills - ein Board, das Bots rankt, sollte sagen, welche davon im einfachen Modus liefen.

Baue die Börse nach, auf der du wirklich handeln wirst

Die drei Schalter oben sind Teil von etwas Größerem. Alles, was diese Engine annimmt, ist ein Feld, das du setzen kannst: die Größe des Buchs und ob es ein echtes Budget ist, was das Durchqueren des Orderbuchs beim Einstieg und beim Ausstieg kostet, wie lange deine Order unterwegs ist, ob eine Order teilweise ausgeführt wird, wie oft die Börse Nein sagt, was du an Gebühren zahlst, ob überhaupt Funding berechnet wird und wo der Liquidationspreis liegt.

Die Standardwerte sind bewusst einfach, und das sollte man offen sagen. Eine Market-Order wird komplett zum Live-Preis ausgeführt, die Maintenance Margin ist pauschal 0.5%, das Guthaben ist eine Anzeigetafel, die eine Eröffnung nie ablehnt, und es gibt weder Latenz noch Auswirkung der Ordergröße. Das ist genau der richtige Ort, um einen Bot zum Laufen zu bringen. Es ist der falsche Ort, um zu beurteilen, ob er einen Vorteil hat. Ein Aufruf ändert das.

GET  /api/bot/v2/sim                    # your profile, every field with its range, and the presets
POST /api/bot/v2/sim {"preset": "realistic"}

# or exactly your own venue
POST /api/bot/v2/sim {"start_balance_usd": 2500, "margin_enforced": true,
                      "slippage": true, "slippage_bps": 8, "impact_bps_per_100k": 15,
                      "latency_ms": 250, "taker_bps": 5.5, "margin_venue": "bybit"}

Werte außerhalb des Bereichs werden abgelehnt, nie begrenzt - eine Strategie darf nie unter einer Einstellung gemessen werden, die du nicht gewählt hast. Eine Position behält Maintenance Margin, Gebührensatz und Exit-Durchquerungskosten, mit denen sie ausgeführt wurde, ein Leben lang; das Einschalten von irgendetwas überschreibt nie einen Trade, den du schon hältst.

Acht Presets, damit du dir keine achtzehn Zahlen ausdenken musst

Jedes Feld, sein Bereich und was es ändert

Was das nicht abbildet - gesagt, statt erst entdeckt

Ein Stop-Loss, Take-Profit oder eine Liquidation wird auf ihrem eigenen Niveau ausgeführt und zahlt nie die Durchquerungskosten: Der serverseitige Sweep läuft über alle Konten gleichzeitig und kann pro Durchlauf kein Profil lesen. Hinter dem Impact-Modell steht kein Orderbuch mit echter Tiefe — impact_bps_per_100k ist eine deklarierte lineare Kostengröße, kein simuliertes Buch. Und die gesamten Durchquerungskosten beim Exit werden gegen den Mark berechnet, also ein Spread, nicht ein Bid und ein Ask, die du getrennt quotieren kannst. Alles andere oben wird genau wie beschrieben angewendet.

Jede Zahl in diesem Profil ist über GET /api/bot/v2/sim auslesbar, auch wie eine Ausführung jetzt gerade aussähe — eine Zahl, die ein Bot nicht zurücklesen kann, muss er raten. GET /api/bot/v2/report sagt dir dann, was die Ausführung tatsächlich gekostet hat: Gebühren, Funding, brutto gegen netto und kept_pct, den Anteil des Brutto, der übrig blieb. Das ist auf jedem Plan kostenlos, denn es ist keine Aufschlüsselung, wo dein Edge liegt — es zeigt, ob der Edge echt ist.

Gebühren wie an der Börse, die du tatsächlich nutzt

Standardmäßig zahlt jede Paper-Ausführung den MarginPad-Satz: 0.055% pro Seite bei Krypto, beide Seiten, als Roundtrip beim Close berechnet. Das ist ein fairer Durchschnitt, aber niemandes exakte Rechnung. Wenn du schon weißt, wo der Bot echt laufen wird, belaste das Paper-Konto nach dem Gebührenplan dieser Börse - ihr veröffentlichter Taker-Satz, abzüglich des Referral-Rabatts, den eine MarginPad-Anmeldung dort bekommt - damit der Forward-Test so abgerechnet wird wie später das Live-Konto:

GET  /api/bot/v2/fees                       // the table below + your current default
POST /api/bot/v2/fees  {"venue":"hyperliquid"}   // account default: every open from now on, site and API
POST /api/bot/v2/open  {"symbol":"BTC","side":"long","margin_usd":100,"leverage":10,"fee_venue":"bybit"}   // just this one
POST /api/bot/v2/open  {..., "dry_run":true}      // -> fee_venue, taker_fee_pct, fee_vs_marginpad_default_usd

Die Sätze sind die veröffentlichten Basis-Tiers der Börsen und die Rabatte, die wir auf /exchanges/ nennen; die API liefert sie mit source zurück, damit du weißt, dass es beworbene Zahlen sind, keine Messungen. Beide Seiten zahlen den Taker-Satz (die Paper-Engine füllt zum Market; ein Maker-Rebate auf einen offenen Einstieg wird nicht modelliert). Nur Crypto-Perps - Aktien, Forex, Metalle und Indizes behalten die MarginPad-Klassensätze, egal welche Börse. Offene Positionen behalten den Satz, mit dem sie ausgeführt wurden; die Obergrenze bei extremem Hebel (ein Round Trip nie über 20% der Margin) gilt weiterhin. Dieselbe Wahl ist der "Gebühren wie bei"-Selektor im Paper Trade-Formular, sodass ein Bot und die manuellen Trades seines Besitzers identische Gebühren zahlen.

Einen Bot schreiben, der nicht kaputtgeht

Sende beim Open immer client_order_id mit. Das ist die wichtigste Zeile dieser Doku. Ohne sie lässt dich ein Request, der im Netzwerk in ein Timeout läuft, raten: Wurde die Position eröffnet oder nicht? Wiederholst du ihn, hast du vielleicht zwei. Mit ihr liefert die Wiederholung die Position, die der erste Aufruf erstellt hat, markiert mit idempotent: true:

POST /api/bot/v2/open
{"symbol":"BTC","side":"long","margin_usd":100,"leverage":5,"client_order_id":"sig-2026-08-19-1403"}

// first call            -> {"ok":true,"data":{"position":{"id":"bot...", ...}}}
// same call retried     -> {"ok":true,"data":{"position":{"id":"bot...", ...},"idempotent":true}}

Nutze einen Wert, den deine Strategie deterministisch neu erzeugen kann - eine Signal-ID oder Symbol plus Kerzen-Zeitstempel. IDs werden 7 Tage gemerkt.

Auch das Schließen akzeptiert eine. Sende client_order_id an /close, und ein Retry meldet, was der erste Aufruf getan hat (idempotent: true), statt eines Fehlers, den du erst deuten musst.

Sende symbol beim Close mit. Jede /positions-Zeile enthält es bereits, daher kostet es nichts und verkürzt den Close messbar:

POST /api/bot/v2/close
{"id":"bot...","symbol":"BTC"}    // one price fetch, one round trip
{"id":"bot..."}                   // server must first look up which symbol to price

Unser Trading-Store ist eine einzelne, an eine Region gebundene Instanz, sodass jeder zusätzliche Hop das kostet, was der Round Trip dorthin von deinem Standort aus kostet. Gemessen am 2026-08-19: etwa 20 ms aus Europa, aber 198 ms im Median und 368 ms im 95. Perzentil aus Singapur. Ein kalter Preis-Feed addiert rund 400 ms, und ohne den Hinweis könnte ein Close auf einem liquiden Paar im selben Batch auf ein illiquides warten. Mit dem Hinweis ist ein Close ein Hop plus ein warmer Preis. Ein falsches oder veraltetes symbol kostet nichts - der Server bemerkt es und fällt zurück.

Verbrenne dein Rate-Budget nicht mit Polling. Die meisten Bots verbrauchen den Großteil ihrer Aufrufe mit der Frage "hat sich etwas geändert". Zwei Dinge machen das fast kostenlos:

# 1. state changes: send back the ETag, get 304 and an empty body when nothing moved
curl -H "X-API-Key: $KEY" -H 'If-None-Match: W/"1a2b3c-4"' \
     https://marginpad.io/api/bot/v1/positions

# 2. live prices: /price is KEYLESS, so it costs nothing against your 120/min
curl https://marginpad.io/api/bot/v1/price?symbol=BTC

Der ETag deckt den strukturellen Zustand ab - Positions-IDs, Status, Menge, Stop, Target, Exit - und bewusst nicht den Mark Price, der sich mit jedem Tick bewegt und den ETag nie passen ließe. Also: Polle /positions für "hat mein Stop ausgelöst", polle das keyless /price für den PnL. Beobachte X-RateLimit-Remaining und gehe bei Retry-After in den Back-off.

WebSocket - hör ganz auf zu pollen

Positionen und Preise werden an dich gepusht, sodass du innerhalb weniger Sekunden erfährst, dass dein Stop ausgelöst hat, statt erst beim nächsten Poll:

wss://marginpad.io/api/bot/v2/stream?api_key=mpb_…

<- {"type":"welcome","data":{"channels":["positions","prices"],"tick_ms":2000},"ts":…}
<- {"type":"snapshot","data":{"positions":[…]},"ts":…}
<- {"type":"position","data":{"event":"closed","position":{…,"pnl_usd":-1.24}},"ts":…}
<- {"type":"prices","data":{"BTC":64770.1},"ts":…}

-> {"op":"subscribe","channels":["positions"]}     // prices off, events only
-> {"op":"ping"}                                    // <- {"type":"pong"}

Events: position mit event: opened | updated | closed feuert, wenn sich wirklich etwas ändert - eine Ausführung, ein verschobener Stop, ein Close, eine Liquidation. prices trägt bei jedem Tick den Mark Price deiner offenen Symbole. Allein eine Mark-Price-Bewegung löst nie ein position-Event aus, der Kanal bleibt also still, wenn nichts passiert ist.

Stops werden schneller abgewickelt, solange du verbunden bist. Der Stream treibt denselben serverseitigen SL/TP/Liquidations-Sweep an, den auch der REST-Pfad nutzt, im Takt von ~2s, statt deine Position dem periodischen Sweep zu überlassen.

Bis zu 3 gleichzeitige Sockets pro Konto, geteilt über deine Keys. Sockets werden nach 6 Stunden recycelt - verbinde dich neu und du erhältst einen frischen snapshot. Reißt die Verbindung ab, behandle den nächsten snapshot als Wahrheit, statt verpasste Events nachzuspielen.

Webhooks - Events, die an deinen Server gepusht werden API PRO

Gemessen über die letzten 40 Tage: 76.4% aller Aufrufe an diese API sind ein Poll von /positions und /account nach Events, die noch nicht passiert sind. Ein Webhook dreht das um - wir senden dir per POST, wenn tatsächlich etwas passiert, mit derselben Position-Form, die ein Poll geliefert hätte, und er funktioniert, während dein Bot offline ist, neu startet oder irgendwo läuft, wo kein Socket gehalten werden kann.

POST /api/bot/v2/webhooks
{"act":"add","url":"https://bot.example.com/marginpad","events":["position.closed","position.liquidated","order.filled"]}

-> {"ok":true,"data":{"webhook":{"id":"wh…","secret":"whs_…","events":[…],"active":true}}}

# what arrives at your URL, seconds after the event:
POST https://bot.example.com/marginpad
X-MP-Event: position.closed        X-MP-Delivery: 1841
X-MP-Timestamp: 1789124656008      X-MP-Signature: sha256=3763dc5d…
{"event":"position.closed","ts":1789124656008,"hook_id":"wh…","data":{"id":"bot…","symbol":"BTC","status":"closed","pnl_usd":-0.08,"close_reason":"SL hit",…}}

Events: position.opened · position.updated (ein Stop oder Ziel wurde verschoben) · position.closed · position.liquidated · order.filled (trägt die Position, die sie erzeugt hat) · order.expired · order.cancelled. Lass events weg, um alle zu erhalten. Trades von der Website auf demselben Account feuern sie ebenfalls.

Prüfe jede Zustellung. X-MP-Signature ist sha256=HMAC_SHA256(secret, raw body) mit dem Secret, das du beim Hinzufügen des Hooks bekommen hast. Vergleiche es, bevor du den Body parst; beide SDKs liefern verify_webhook / verifyWebhook mit. Antworte innerhalb von 6 Sekunden mit 2xx - alles andere wird 5-mal mit Back-off wiederholt (30 s, 1, 2, 4 Min), und ein Hook wird nach 25 aufeinanderfolgenden Fehlern pausiert; GET /webhooks zeigt active, consecutive_failures und last_error, damit du siehst, warum. Drei Hooks pro Konto bei Pro, fünfzehn bei Max, fünfzig bei Business; Zustellungen erfolgen nach bestem Bemühen, der WebSocket-snapshot und /positions bleiben die Quelle der Wahrheit.

Probiere es, bevor du einen Empfänger schreibst: Registriere https://marginpad.io/api/whsink/<any-token-you-choose> als URL und rufe dann GET auf derselben Adresse auf - sie gibt die letzten 20 Zustellungen (Header und Body) 15 Minuten lang zurück. Keine Authentifizierung; der Token ist das Geheimnis.

Books - eine Strategie, ein sauberes Ergebnis 2.5

Ein Book ist ein eigenes Journal mit eigenem Guthaben, Report und eigener Equity-Kurve innerhalb deines Kontos. Erstelle einen Key mit einem Book-Namen, und jeder Aufruf mit diesem Key handelt dieses Book; dein Hauptkonto und deine anderen Books sehen ihn nie. Free-Konten bekommen ein Book neben dem Hauptkonto, API Pro fünf, Max zwanzig und Business fünfzig.

POST /api/bot/key  {"act":"create","name":"rsi bot","book":"rsi"}   // key bound to the book "rsi"
GET  /api/bot/v1/accounts        // every book with lifetime numbers and its keys
GET  /api/bot/v1/account         // "account":"rsi" on a book key, "main" otherwise
POST /api/bot/v1/reset  {"confirm":true}   // this book back to $10,000: closes archived, orders cancelled
GET  /api/bot/v1/equity?days=30&step_min=60   // equity curve + max_drawdown_pct

Reset wird mit 409 open_positions_exist abgelehnt, solange etwas offen ist: erst schließen, dann zurücksetzen. Die archivierten Trades bleiben erhalten (nie gelöscht), aber Report, Ledger, /trades und die Equity-Kurve starten ab dem Reset, und ein Browser, der noch das alte Journal hält, kann es nicht zurückschieben. Webhooks feuern auf den Hooks des Kontos mit "account":"rsi" im Payload, sodass ein Empfänger jedes Book bedient.

Replay - lass deinen Bot einen vergangenen Tag durchlaufen 2.6

Backteste mit dem Code, den du live laufen lässt. Starte ein Replay eines vergangenen UTC-Tages, und dieselben Routen, die dein Bot schon aufruft, wirken auf ein separates Replay-Journal, bepreist aus den 1-Minuten-Kerzen von MarginPad am Cursor. Stops, Ziele und Liquidationen werden bei jeder Kerze zwischen zwei deiner Aufrufe auf High und Low geprüft, mit derselben Gebühren- und Funding-Mathematik wie live. Nichts aus einem Replay erreicht die Boards, die Arena oder deinen Report.

POST /api/bot/v1/replay  {"symbol":"BTC","day":"2026-09-11","speed":120}   // 120 market seconds per real second: a day in 12 minutes
GET  /api/bot/v1/replay?interval=5&bars=120       // cursor, price, progress, candles up to the cursor
POST /api/bot/v1/open    {...}                        // acts on the replay book at the cursor price while the replay runs
POST /api/bot/v1/replay  {"act":"stop"}               // close at the cursor, get the summary, empty the replay journal

Die Geschwindigkeit reicht von 1 (Echtzeit) bis 600 (ein Tag in 2.4 Minuten). Ein Replay pro Key gleichzeitig, nur Crypto, vorerst nur Market-Orders: Lies Replay-Preis und Kerzen über GET /v1/replay, denn das keylose /v1/price und /v1/klines liefern weiter Live-Daten.

Deine Keys verwalten

Du kannst mehrere Keys auf einem Konto halten - trenne einen Backtest-Bot von einem Live-Bot und widerrufe einen, ohne den anderen anzufassen. Nutzung und Rate-Limits werden pro Key gezählt, daher hat jeder ein eigenes Budget und eine eigene Zeile in deinen Statistiken. Auf der Website angemeldet, aus dem Browser:

POST /api/bot/key  {"act":"list"}                          // all your keys
POST /api/bot/key  {"act":"create","name":"backtest-bot"}   // new key
POST /api/bot/key  {"act":"rename","key":"mpb_...","name":"live-bot"}
POST /api/bot/key  {"act":"revoke","key":"mpb_..."}         // usage history is kept

Ein widerrufener Key liefert 401 revoked_key. Keys sind Geheimnisse - wer einen hält, kann dein Paper-Konto handeln. Erstelle und widerrufe sie oben auf dieser Seite.

Bot-Arena - eine öffentliche Rangliste für Bots

Jeder Account und jedes Book mit mindestens fünf geschlossenen Trades, die in dieser 14-Tage-Season über die API eröffnet wurden, wird auf /arena/ nach realisiertem PnL netto nach Gebühren und Funding gerankt, mit Trefferquote, Rendite auf die $10,000-Scorecard, durchschnittlichem ROE und Liquidationen. Keine Preisgelder und nichts zum Anmelden: Handle über die API, und das Board erfasst dich. JSON: GET /api/arena.

Nutze es aus Claude, ChatGPT oder Cursor

MarginPad betreibt einen Remote-MCP-Server, damit ein KI-Assistent Märkte lesen und dein Paper-Konto direkt handeln kann - ohne Glue-Code:

https://marginpad.io/mcp

Füge ihn in deinem Client als Remote-MCP-Server hinzu und setze den Header X-API-Key: mpb_…, wenn du die Paper-Trading-Tools willst. Marktdaten-Tools brauchen keinen Key. Es stehen achtundzwanzig Tools zur Verfügung: Preise, Kerzen, Märkte, Screener, Funding, Open Interest, Liquidationen, Fear and Greed, der Wirtschaftskalender, zwei Rechner, und Paper open (mit Trailing Stops und Dry Run) / Limit- und Stop-Orders / modify / cancel / close / sltp / positions / orders / balance / trades / report / fees / accounts / reset / equity / replay. GET /mcp im Browser liefert den Server-Descriptor.

Antwortformat - v1 und v2

/api/bot/v1/* ist eingefroren. Seine Response-Bodys ändern sich nicht; dagegen geschriebene Bots laufen unbegrenzt weiter, und es bekommt weiterhin Korrektheits-Fixes.

/api/bot/v2/* ist dieselbe API mit dem Envelope, den unsere Daten-Endpoints bereits nutzen - eine vorhersehbare Form für Erfolg und Fehler, sodass du das Parsing nur einmal schreibst:

{ "ok": true,  "data": { ... }, "ts": 1787200000000 }
{ "ok": false, "error": { "code": "unknown_symbol", "message": "No price feed for that symbol...", "symbol": "FOO" }, "ts": 1787200000000 }

Gleiche Pfade, gleiche Parameter, gleicher Key - ersetze v1 in der URL durch v2. Die code-Werte der Fehler sind stabile Bezeichner; message ist für Menschen und kann umformuliert werden.

Fehlercodes

Bei /v2 sind Fehler immer {"ok":false,"error":{"code","message"},"ts"}. Der code ist ein stabiler Bezeichner, nach dem du verzweigen kannst; die message ist Fließtext und kann umformuliert werden. Manche Fehler tragen den Wert, den du zur Korrektur brauchst - sl_wrong_side und tp_wrong_side enthalten den Live-Preis.

Immer noch festgefahren? Der Error-Body ist die erste Anlaufstelle, Status die zweite. Wenn beides nicht hilft, schreib an support@marginpad.io mit dem Endpoint und dem genauen Body, den wir zurückgeschickt haben - was du sonst noch angeben solltest, steht auf der Support-Seite. Ein Mensch liest es.

Kostenlose Liquidationsdaten-API LIVE-DATEN

Liquidationen in Echtzeit, aggregiert von acht Börsen durch unseren eigenen Collector - die Daten hinter unserem Rekt-Feed und der Liquidations-Heatmap, als kostenloses JSON bereitgestellt. Vergleichbare Daten kosten anderswo üblicherweise $300+/Monat; hier brauchst du überhaupt keinen API-Key. Edge-gecacht und ratenbegrenzt, damit er pollende Bots problemlos verkraftet.

Namensnennung erwünscht (verlinke marginpad.io), aber nicht Pflicht. Abdeckung: ~70%+ des Liquidationsflusses am Markt - die Börsen, die den Preis bewegen. Zu Lernzwecken; kein Uptime-SLA. Du willst nur Marktdaten? Die gesamte keyless Oberfläche ist auf der Seite Free Crypto Data API dokumentiert.

Backtest, Paper, Live - in dieser Reihenfolge

Die meisten Krypto-Trading-Bots, die im Backtest profitabel aussehen, verlieren in der ersten Woche live Geld. Backtests spielen saubere historische Kerzen ab - sie erkennen keine Race Condition in deiner Order-Logik, keinen Fehler bei der Positionsgröße, der erst nach einer Verlustserie auftritt, und keinen Hebel, der unbemerkt über das wächst, was deine Margin übersteht. Forward-Testing lässt denselben Bot, denselben Codepfad, gegen echte Live-Preise in Echtzeit laufen. Hat die Strategie einen Fehler, zeigt er sich hier, wo ein Bug dich nichts kostet.

Der mittlere Schritt ist der, den die meisten überspringen - und der, der ihnen Geld gespart hätte. Backteste hier eine Idee, teste sie vorwärts mit dieser API und finanziere dann ein Konto.

FAQ

Guides und Tutorials