MarginPad API

Alles, was die Seite weiß, als JSON: Live-Preise und Kerzen, ein bewerteter Screener, Funding, Open Interest, Long/Short, an acht Börsen gemessene Liquidationen, ein Wirtschaftskalender - ohne Key. Dazu eine vollständige Paper-Trading Bot API, um einen Trading-Bot mit echten Preisen und ohne echtes Geld zu forward-testen, ein Remote-MCP-Server, damit ein KI-Assistent all das nativ nutzen kann, eine OpenAPI-3.1-Spezifikation und Python- und JavaScript-Clients in einer Datei.

Marktdaten - /api/v1/*, ohne Key

Jede Antwort ist der Envelope { ok, data, ts } ({ ok:false, error:{ code, message } } bei Fehlern) mit aktiviertem CORS, sodass eine Browserseite sie direkt aufrufen kann. 60 Anfragen pro Minute und IP ohne Key. Sende bei denselben Aufrufen einen kostenlosen X-API-Key (von /trading-api/), dann werden sie gegen deinen Key gezählt - 120 pro Minute, 600 mit Premium. Vollständiges Handbuch mit Beispielen: /free-crypto-api/.

curl "https://marginpad.io/api/v1/price?symbol=BTC"
curl "https://marginpad.io/api/v1/screener"
curl -H "X-API-Key: mpb_..." "https://marginpad.io/api/v1/klines?symbol=ETH&interval=15"   # counts against your key, not your IP

Paper-Trading Bot API - /api/bot/v1/* und /api/bot/v2/*

Richte einen Trading-Bot auf echte Live-Preise und verbuche jeden Trade in simulierten Dollar: Isolated Margin, Hebel bis zu 1000×, Liquidationen bestätigt auf 1-Minuten-Kerzen, Taker-Gebühren und Funding wie an einer Börse. Melde dich mit einer E-Mail an und erstelle einen Key unter /trading-api/; Positionen liegen in deinem Konto und zählen für die Season-Boards. Die v1-Antwortformate sind eingefroren; v2 ist dieselbe API im { ok, data, ts }-Envelope. Auth: X-API-Key.

Die vollständige Dokumentation, der Quickstart, Fehlercodes und die Hinweise zur Zuverlässigkeit (Idempotenz, ETags, der WebSocket) stehen auf /trading-api/. Jede Änderung wird unter /api/changelog protokolliert (JSON unter /api/changelog?format=json); die aktuelle Version ist 2.4.0.

MCP - nutze es aus Claude, ChatGPT oder Cursor

Füge https://marginpad.io/mcp als Remote-MCP-Server hinzu (Streamable HTTP). Marktdaten-Tools brauchen keinen Key; setze für die Paper-Trading-Tools den Header X-API-Key. 23 Tools: get_price, get_klines, get_markets, get_screener, get_funding, get_open_interest, get_liquidations, get_fear_greed, get_economic_calendar, calc_liquidation, calc_position_size, paper_balance, paper_positions, paper_trades, paper_open, paper_close, paper_sltp, paper_modify_order, paper_fees, paper_report, paper_limit_order, paper_orders, paper_cancel_order.

Clients - eine Datei, keine Abhängigkeiten

marginpad.py (Python 3.8+, nur urllib; websockets optional für den Stream) und marginpad.js (Node 18+ oder ein Browser). Beide decken Marktdaten, jeden Paper-Trading-Aufruf, ETag-Polling, 429-Back-off, den WebSocket-Stream und die Prüfung der Webhook-Signatur ab.

from marginpad import MarginPad
mp = MarginPad("mpb_...")                              # key from /trading-api/
print(mp.price("BTC"))                                 # keyless market data
r = mp.open("BTC", "long", margin_usd=100, leverage=10, trail_pct=1.5,
            client_order_id="sig-1403")                # a retry can never open twice
print(r["position"]["liq_price"], mp.report()["skill"])

Rechner - /api/*, reines JSON

Eine kostenlose, öffentliche JSON-API für die gängigsten Krypto-Futures-Berechnungen. Kein API-Key, keine Anmeldung, CORS-fähig - ruf sie von überall auf.

Base URL   https://marginpad.io/api
Method     GET
Auth       none
CORS       enabled (Access-Control-Allow-Origin: *)
Format     JSON   (also under /api/v1/calc/* in the { ok, data, ts } envelope)

Liquidationspreis

{
  "side": "long",
  "liquidationPrice": 54300,
  "distancePct": -9.5
}

Positionsgröße (nach Risiko)

{ "positionSize": 0.041667, "notional": 2500, "riskAmount": 50, "marginRequired": 250 }

PnL / ROI / ROE

{ "pnl": 3000, "roiPct": 10, "roePct": 100 }

Chance-Risiko-Verhältnis

{ "riskRewardRatio": 3, "riskPerUnit": 2000, "rewardPerUnit": 6000, "breakevenWinRatePct": 25 }

Take-Profit-Ziel

{ "targetExitPrice": 64500, "priceMovePct": 7.5 }

Hinweise

Die Berechnungen nutzen die Isolated-Margin-Schätzung und dienen nur Bildungszwecken, nicht als Finanzberatung. Zahlen enthalten keine Börsengebühren und kein Funding. Die API wird kostenlos und ohne Gewähr bereitgestellt. Wenn du damit etwas baust, freuen wir uns über einen Link zu marginpad.io. Marktdaten sind für die öffentliche Nutzung kostenlos, Quellenangabe erwünscht; die Bot API ist ein Simulator und berührt nie echtes Geld. Nur zu Bildungszwecken, keine Finanzberatung.