API MarginPad
Tout ce que le site sait, en JSON : prix et bougies en direct, un screener noté, funding, open interest, long/short, liquidations mesurées sur douze exchanges, un calendrier économique - sans clé. Plus un Bot API de paper trading complet pour tester un bot de trading en conditions réelles sur de vrais prix sans argent réel, un serveur MCP distant pour qu'un assistant IA puisse tout utiliser nativement, une spécification OpenAPI 3.1 et des clients Python et JavaScript en un seul fichier.
marginpad.py / marginpad.js sans dépendance.Spécification →
Données de marché - /api/v1/*, sans clé
Chaque réponse est l'enveloppe { ok, data, ts } ({ ok:false, error:{ code, message } } en cas d'échec) avec CORS activé, pour qu'une page web puisse l'appeler directement. 60 requêtes par minute et par IP sans clé. Envoie une X-API-Key gratuite (obtenue sur /trading-api/) sur les mêmes appels et ils sont décomptés sur ta clé à la place - 120 par minute, 600 avec Premium. Manuel complet avec exemples : /free-crypto-api/.
| Endpoint | Ce que tu obtiens | |
|---|---|---|
| GET | /api/v1/price?symbol=BTC | Prix en direct d'un coin, agrégé sur Binance / Bybit / OKX / Gate. |
| GET | /api/v1/prices | Instantané groupé des principaux coins en un seul appel. |
| GET | /api/v1/klines?symbol=BTC&interval=60 | Bougies OHLC : 1, 5, 15, 60, 240, 1440 minutes ; jusqu'à 1000 par appel, &end= pour remonter dans l'historique. |
| GET | /api/v1/symbols | ~500 symboles perp USDT liquides, classés par volume. |
| GET | /api/v1/screener | Screener de futures noté : score 0-100, verdict, RSI, MACD, tendance, setup ATR. |
| GET | /api/v1/funding | Taux de funding sur ~160 paires, mesurés depuis les endpoints publics des exchanges. |
| GET | /api/v1/open-interest | Open interest (USD) sur ~160 paires. |
| GET | /api/v1/long-short | Ratio de comptes long/short sur les majeurs (Binance + OKX + Bybit). |
| GET | /api/v1/liquidations | Totaux de liquidations 24h par coin, longs contre shorts, issus de notre propre collecteur sur douze exchanges. |
| GET | /api/v1/venues | Liquidations par exchange : total 24h, part, répartition long/short. |
| GET | /api/v1/feed | Les événements de liquidation les plus récents sur tous les symboles (quelques secondes de retard sur les exchanges). |
| GET | /api/v1/liquidations/live?symbol=BTC | Événements de liquidation récents bruts pour un symbole. |
| GET | /api/v1/liquidations/recent?symbol=BTC&minutes=1440 | Histogramme long/short par tranches de temps, jusqu'à 30 jours. |
| GET | /api/v1/clusters?symbol=BTC | Clusters de liquidation modélisés : les niveaux de prix où se trouvent les ventes forcées en ce moment. |
| GET | /api/v1/calendar | FOMC, CPI, NFP, expirations d'options et jalons crypto, avec horodatage UTC. |
| GET | /api/v1/fear-greed | Indice Fear & Greed, valeur et classification. |
| GET | /api/v1/coins | Top ~250 coins : prix, capitalisation, variation 1h/24h/7j, sparkline. |
| GET | /api/v1/global | Capitalisation totale, volume, dominance BTC. |
| GET | /api/v1/trending | Coins tendance. |
| GET | /api/v1/defi | TVL DeFi : blockchains, protocoles, stablecoins. |
| GET | /api/latam/ar · /api/latam/br | Cotations régionales : l'USDT en pesos argentins sur 35 exchanges ; le Bitcoin et l'USDT en réais avec la prime sur le dollar commercial. |
| GET | /api/v1/calc/liquidation · position-size · pnl · risk-reward · take-profit | Les cinq calculateurs ci-dessous, dans la même enveloppe. |
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
Bot API de paper trading - /api/bot/v1/* et /api/bot/v2/*
Branche un bot de trading sur de vrais prix en direct et règle chaque trade en dollars simulés : marge isolée, levier jusqu'à 1000×, liquidations confirmées sur des bougies 1 minute, frais taker et funding facturés comme sur un exchange. Connecte-toi avec un email et génère une clé sur /trading-api/ ; les positions vivent sur ton compte et comptent pour les classements de la saison. Les formats de réponse v1 sont figés ; v2 est la même API dans l'enveloppe { ok, data, ts }. Authentification : X-API-Key.
| Endpoint | Ce que ça fait | |
|---|---|---|
| GET | /api/bot/v1/price · /klines · /time · /markets | Prix d'exécution, bougies, horloge serveur (avec drift_ms) et chaque symbole tradable avec son levier maximal et ses frais - les trois premiers ne demandent aucune clé. |
| POST | /api/bot/v1/open | Ouverture au marché au prix en direct, avec en option sl, tp, trail_pct 2.3, client_order_id (relances idempotentes) et dry_run 2.3 (calcule le prix sans rien enregistrer). |
| POST | /api/bot/v1/open type: limit | stop | Des ordres en attente exécutés À ton niveau à partir des bougies 1m pendant que le bot est hors ligne : un ordre limite sous le marché ou une entrée stop au-dessus 2.3. |
| GET | /api/bot/v1/orders | Ordres en attente (avec type) plus les 20 derniers exécutés, expirés ou annulés. |
| POST | /api/bot/v1/modify_order | Modifie un ordre en attente sur place : prix, sl, tp, marge, levier, trailing stop 2.3. |
| POST | /api/bot/v1/cancel_order | Annule un ordre en attente (un ordre exécuté répond 409, donc une relance ne peut jamais annuler une exécution). |
| POST | /api/bot/v1/close · /close_all | Clôture une position, partiellement avec pct, ou tout d'un coup ; le P&L se règle net des frais aller-retour et du funding. |
| POST | /api/bot/v1/sltp | Déplace le stop-loss, le take-profit ou le trailing stop d'une position ouverte sans la clôturer. |
| GET | /api/bot/v1/positions?status=open | Positions avec mark price en direct et P&L ; ETag / 304 quand rien n'a changé ; ?since=. |
| GET | /api/bot/v1/trades · /account · /balance · /usage | Historique paginé des trades clôturés, statistiques du compte depuis l'ouverture, solde et equity, ton plan avec ses limites et ses droits. |
| GET | /api/bot/v1/fees | Facture tes exécutions fictives selon la grille taker d'une vraie plateforme, moins notre réduction de parrainage (Bybit, Binance, OKX, Bitget, MEXC, Gate, KuCoin, Kraken, Hyperliquid) ; un POST définit la valeur par défaut du compte, fee_venue à l'ouverture la remplace 2.4. |
| GET | /api/bot/v1/report?days=30 | Ton rapport de trading sur 30 jours : totaux et score de compétence gratuits ; détail par coin / levier / sens / heure / jour et constats rédigés avec Premium 2.3. |
| WS | wss://marginpad.io/api/bot/v2/stream?api_key=… | Événements de position ouverte / mise à jour / clôturée et mark prices poussés toutes les ~2 s. Gratuit sur tous les plans. |
| GET | /api/bot/v1/webhooks Premium | Les événements de trading envoyés en POST vers ta propre URL, signés HMAC-SHA256 et relancés, que le bot soit connecté ou non 2.3. |
| POST | /api/bot/v1/ai Premium | La lecture IA du panneau de graphique via l'API : une réponse, un plan structuré et le brief sur lequel elle a raisonné, 50 par jour 2.3. |
| Plan | Gratuit | Premium ($11.99/mois) |
|---|---|---|
| Requêtes / minute par clé (trading et données de marché) | 120 | 600 |
| Clés API · positions ouvertes · ordres en attente | 3 · 50 · 20 | 10 · 200 · 20 |
| Données de marché, WebSocket, MCP, ordres limite & stop, trailing stops, modification, dry run, grilles de frais par plateforme | inclus | inclus |
| Webhooks · lecture de marché IA · détails du rapport | - | 3 hooks · 50/jour · rapport complet |
La documentation complète, le quickstart, les codes d'erreur et les notes de fiabilité (idempotence, ETags, le WebSocket) sont sur /trading-api/. Chaque changement est consigné sur /api/changelog (JSON sur /api/changelog?format=json) ; la version actuelle est la 2.4.0.
Tout ce qui précède se règle en dollars simulés. Une fois qu'une stratégie a survécu à des semaines de tests en conditions réelles, le même code a besoin d'une API live pour passer de vrais ordres. Deux plateformes que nous recommandons aux créateurs de bots :
Des perps sur leur propre blockchain avec une API REST et WebSocket publique, des sous-comptes qui ont chacun leur propre wallet API, un funding horaire et un carnet d'ordres que n'importe qui peut auditer on-chain.
avec le code MARGINPAD
Des formats REST et WebSocket proches de cette API, une clé distincte par sous-compte, et l'un des flux dont proviennent nos propres prix. Le choix par défaut quand tu veux un carnet centralisé avec des rampes d'accès fiat.
Ouvrir un compte Bybit →MCP - utilise-le depuis Claude, ChatGPT ou Cursor
Ajoute https://marginpad.io/mcp comme serveur MCP distant (Streamable HTTP). Les outils de données de marché ne demandent aucune clé ; ajoute l'en-tête X-API-Key pour les outils de paper trading. 23 outils : 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 - un fichier, zéro dépendance
marginpad.py (Python 3.8+, urllib uniquement ; websockets en option pour le flux) et marginpad.js (Node 18+ ou un navigateur). Les deux couvrent les données de marché, chaque appel de paper trading, le polling par ETag, le back-off sur les 429, le flux WebSocket et la vérification de signature des webhooks.
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"])
Calculateurs - /api/*, JSON simple
Une API JSON publique et gratuite pour les calculs de futures crypto les plus courants. Sans clé API, sans inscription, CORS activé - appelle-la de n'importe où.
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)
Prix de liquidation
| entry | requis - prix d'entrée |
| leverage | requis - multiple de levier (>0) |
| side | optionnel - long (par défaut) ou short |
| mmr | optionnel - taux de marge de maintenance en %, 0.5 par défaut |
{
"side": "long",
"liquidationPrice": 54300,
"distancePct": -9.5
}
Taille de position (selon le risque)
| balance | requis - solde du compte |
| risk | requis - risque par trade en % |
| entry | requis - prix d'entrée |
| stop | requis - prix du stop-loss |
| leverage | optionnel - pour la marge requise |
{ "positionSize": 0.041667, "notional": 2500, "riskAmount": 50, "marginRequired": 250 }
PnL / ROI / ROE
{ "pnl": 3000, "roiPct": 10, "roePct": 100 }
Risque / rendement
{ "riskRewardRatio": 3, "riskPerUnit": 2000, "rewardPerUnit": 6000, "breakevenWinRatePct": 25 }
Objectif du take-profit
{ "targetExitPrice": 64500, "priceMovePct": 7.5 }
Remarques
Les calculs utilisent l'estimation en marge isolée et sont fournis à titre éducatif, pas comme un conseil financier. Les chiffres excluent les frais d'exchange et le funding. L'API est fournie gratuitement et en l'état. Si tu construis quelque chose avec, un lien vers marginpad.io est apprécié. Les données de marché sont libres pour un usage public, une attribution est appréciée ; le Bot API est un simulateur et ne touche jamais à de vrais fonds. À but éducatif uniquement, ceci n'est pas un conseil financier.
Construis quelque chose avec
Obtiens une clé API gratuite en une minute, ou colle l'URL MCP dans ton assistant et demande-lui ce qui semble haussier en ce moment.
Obtenir une clé API gratuite →