Une API de paper trading de futures sur de vrais prix en direct. Ton bot ouvre des positions à levier, place des ordres limite et stop en attente, fait suivre ses stops et se fait liquider - le tout réglé sur nos serveurs, en dollars simulés. Le même code que tu feras tourner en réel, sans aucune des conséquences.
Sans carte, sans KYC, sans dépôt. Toutes les conditions d'exécution sont à toi - taille du carnet, slippage, latence, exécutions partielles, refus, frais. Gratuit pour toujours à 120 requêtes par minute - API Premium coûte $11.99 quand tu veux notre archive de marché, les webhooks et plusieurs books. Les données de marché restent accessibles sans clé sur tous les plans.
# no key needed - run this right now curl "https://marginpad.io/api/bot/v1/price?symbol=BTC" { "symbol": "BTC", "price": …, "ts": … }
curl -X POST ".../v1/open" -H "X-API-Key: mpb_…" \ -d '{"symbol":"BTC","side":"long","margin_usd":100, "leverage":10,"trail_pct":1.5}' { "ok": true, "position": { "id": "bot_9f21…", "entry": …, "liq_price": …, "trail_pct": 1.5, "fee_round_trip_usd": 1.10 } }
Connecte-toi avec un email - sans mot de passe, sans KYC. Les positions de ton bot sont conservées sur ton compte, et un compte peut avoir plusieurs clés pour qu'un bot de backtest et un bot en réel ne partagent jamais le même budget de requêtes.
| Nom | Book | Clé | Appels | Dernière utilisation |
|---|
Tes clés, leur utilisation et le book dans lequel chacune trade s'affichent ici une fois que tu es connecté. Les clés sont secrètes - quiconque en détient une peut trader ton compte de paper trading.
Le gratuit n'a ni limite de durée ni carte : tout le moteur de trading, les vrais frais des exchanges, les entrées limite et stop, les trailing stops, le replay, la simulation configurable, le flux WebSocket et toutes les données de marché en direct. API Premium ajoute ce qu'il faut pour un vrai projet - notre archive de marché via l'API (9 datasets que personne d'autre ne publie, chaque liquidation depuis juillet 2026), le carnet d'ordres brut, les webhooks, plusieurs books et 90 jours d'historique de trades. C'est un abonnement distinct du Premium du site.
Tout ce qu'il faut pour tester un bot : tout le moteur, le flux, le replay et les données de marché en direct. Sans carte, sans essai, sans compte à rebours.
Pour construire du sérieux : backteste sur notre historique mesuré, réagis aux webhooks, fais tourner une famille de stratégies côte à côte.
/v1/history - 9 datasets, un CSV vérifié par jour UTC| Ce qui change selon le plan | Free | API Premium · $11.99 |
|---|---|---|
Archive de marché /v1/historyliquidations, agg5m, oi, funding_oi, whale_fills, whale_pos, catalysts, longshort, mpad | le catalogue | chaque jour, chaque dataset |
| Carnet d'ordres brut par exchange | carnet consolidé uniquement | oui |
| Books - un journal, un solde et un rapport distincts par stratégie | 1 | 20 |
| Webhooks - signés, avec relances, livrés même quand tu es hors ligne | aucun | 15 |
| Historique de trades conservé ce que /v1/trades, le rapport et la courbe d'equity peuvent encore voir | 30 jours | 90 jours |
Trading Report /v1/report | totaux, score de compétence, coûts | + détails & constats |
| Clés API · positions ouvertes | 3 · 50 | 30 · 500 |
Requêtes par minute, par clé (moteur et /api/v1/* avec la clé)60 / min par IP sans clé, sur tous les plans | 120 | 2000 |
Sur tous les plans, Free compris : tout le moteur de trading - ordres au marché, limite et stop, trailing stops, clôtures partielles, dry run et replay - le stream WebSocket, le serveur MCP, la grille de frais de 9 vraies plateformes, de $1 à $100,000 de marge par trade avec un levier jusqu'à 1000×, et tous les endpoints de données de marché sans clé à pleine vitesse. Les plans payants relèvent les plafonds. Ils ne débloquent pas le produit.
Premium est un produit différent. Un abonnement MarginPad Premium débloque des fonctionnalités sur le site - les indicateurs exclusifs sur les graphiques, la heatmap de liquidations, Ask AI sur les graphiques - et depuis le 15 septembre 2026, il ne modifie aucune limite de l'API. Ces plans ne débloquent pas non plus ces fonctionnalités du site. Prends celui que tu utilises vraiment.
Les plans sont au mois, payés en crypto ou directement depuis ton solde de récompenses MarginPad, et un mois acheté en avance s'ajoute à celui que tu as au lieu de le remplacer. Tes plafonds en vigueur sont toujours dans GET /api/bot/v1/usage - limits, features, plan_until - pour qu'un bot puisse les lire au lieu de deviner.
Ce que tu achètes, noir sur blanc. La section 9 des conditions couvre l'API à part : ce qu'inclut un plan et ce qui se passe le jour où il prend fin, le fait que rien ne se renouvelle automatiquement et qu'il n'y a rien à résilier, ce à quoi nous nous engageons ou non en matière de disponibilité (il n'y a pas de SLA - nous le disons, et nous disons à quoi nous nous engageons à la place), un préavis de trente jours avant tout changement incompatible, et le fait que tu peux construire et vendre des produits commerciaux sur cette API sans nous demander l'autorisation.
Ton bot est prévenu avant que le plan n'expire, pas après. Chaque réponse avec clé contient X-MP-Plan, et pendant les quatorze derniers jours elle contient aussi X-MP-Plan-Expires et X-MP-Plan-Days-Left. Enregistre-les dans tes logs et un bot sans surveillance pourra te prévenir lui-même ; le même compte à rebours figure sur cette page et dans /v1/usage. Un plan qui expire fait repasser la clé sur Free - elle ne cesse jamais de répondre.
La première n'a besoin d'aucune clé - colle-la dans un terminal avant de décider quoi que ce soit. Chaque chemin ci-dessous existe en v1 figée et en v2 avec enveloppe ; choisis-en une et elle ne bougera pas sous tes pieds.
GET /v1/price et /v1/klines sont sans clé et compatibles CORS. Jusqu'à 1,000 bougies par appel, sept intervalles, pagination vers l'arrière avec &end= pour tout l'historique dont un backtest a besoin.
POST /v1/open exécute au prix en direct en marge isolée et te renvoie le niveau de liquidation. Ajoute type:"limit" ou "stop" pour placer un ordre en attente côté serveur, ou dry_run pour chiffrer un trade sans rien écrire.
Les stops, objectifs, trailing stops et liquidations se règlent de notre côté, sur des bougies de 1 minute, que ton bot tourne ou non. Ouvre le WebSocket et le résultat arrive en deux secondes environ - c'est gratuit sur tous les plans, et c'est la différence entre un bot qui réagit et un bot qui attend sa prochaine boucle.
# price (no key)
curl "https://marginpad.io/api/bot/v1/price?symbol=SOL"
# open a 20x long with $100 margin
curl -X POST "https://marginpad.io/api/bot/v1/open" \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"symbol":"SOL","side":"long","margin_usd":100,"leverage":20}'
# check live P&L
curl "https://marginpad.io/api/bot/v1/positions" -H "X-API-Key: YOUR_KEY"
# close half, let the rest run
curl -X POST "https://marginpad.io/api/bot/v1/close" \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"id":"POSITION_ID","pct":50}'
# the whole loop, without a single poll
const { MarginPad } = require("marginpad");
const mp = new MarginPad("YOUR_KEY");
mp.stream(ev => {
if (ev.type === "snapshot") console.log("open now:", ev.data.positions.length);
if (ev.type === "position") {
const p = ev.data.position; // opened | updated | closed
console.log(ev.data.event, p.symbol, p.pnl_usd ?? p.unrealized_pnl_usd);
if (ev.data.event === "closed") decideWhatIsNext(p);
}
});
# or with nothing but a URL - any language with a WebSocket client
wscat -c "wss://marginpad.io/api/bot/v2/stream?api_key=mpb_..."
<- {"type":"welcome","data":{"channels":["positions","prices"],"tick_ms":2000}}
<- {"type":"snapshot","data":{"positions":[...]}}
<- {"type":"position","data":{"event":"closed","position":{...,"pnl_usd":-1.24}}}
Mesuré, et c'est la raison d'être de cet onglet : 76.4% de tous les appels à cette API sur les 40 derniers jours étaient un polling de /positions ou /account - 890,921 et 471,390 appels - alors que le WebSocket a été ouvert 15 fois en tout. Le flux est gratuit sur tous les plans exprès - le restreindre renverrait tout le monde au polling, qui nous coûte plus cher que le flux. Si tu dois faire du polling, renvoie l'ETag : un poll sans changement coûte alors un 304 avec un corps vide.
# python - the official client, zero dependencies
pip install marginpad
from marginpad import MarginPad
mp = MarginPad("YOUR_KEY")
price = mp.price("BTC")["price"]
if my_signal(price): # your strategy here
r = mp.open("BTC", "long", margin_usd=50, leverage=10,
sl=price * 0.97, trail_pct=1.5, # trailing stop, ratcheted server-side
client_order_id=f"sig-{int(time.time())}") # a retry can never open twice
print("opened", r["position"]["id"], "liq @", r["position"]["liq_price"])
changed = mp.positions(status="open") # None when nothing changed (ETag / 304)
print(mp.report()["skill"])
# node.js - the official client, zero dependencies
npm install marginpad
const { MarginPad } = require("marginpad");
const mp = new MarginPad("YOUR_KEY");
const { price } = await mp.price("ETH");
if (mySignal(price)) { // your strategy here
const { position } = await mp.open({ symbol: "ETH", side: "short", margin_usd: 50, leverage: 10,
trail_pct: 2, client_order_id: "sig-" + Date.now() });
console.log("opened", position.id, "liq @", position.liq_price);
}
mp.stream(ev => { if (ev.type === "position") console.log(ev.data.event, ev.data.position.id); });
# plain HTTP, any language
import requests
API = "https://marginpad.io/api/bot"; H = {"X-API-Key": "YOUR_KEY"}
r = requests.post(f"{API}/v2/open", headers=H, json={"symbol": "BTC", "side": "long",
"margin_usd": 50, "leverage": 10, "dry_run": True}).json() # priced, nothing written
print(r["data"]["position"]["fee_round_trip_usd"], r["data"]["position"]["liq_price"])
Authentifie-toi avec X-API-Key à chaque appel, sauf /price, /klines et /time. Clients officiels, zéro dépendance - npm install marginpad ou pip install marginpad, ou un seul fichier chacun : marginpad.py · marginpad.js - REST, WebSocket, polling par ETag, back-off sur les 429 et vérification de signature des webhooks intégrés.
Les carnets des testnets sont minces, leurs prix s'écartent du vrai marché, et ils se réinitialisent sans prévenir. Ici, tout est valorisé à partir du flux multi-exchange en direct qu'utilisent nos propres graphiques - seuls les dollars sont simulés.
Dix-huit champs et huit presets : la taille du book et s'il s'agit d'un vrai budget, ce que coûte la traversée du carnet d'ordres à l'entrée et à la sortie, combien de temps ton ordre est en transit, les exécutions partielles, la fréquence des refus de la plateforme, tes propres frais, le funding et l'emplacement de la liquidation. Freqtrade te laisse régler le solde de départ et rien d'autre ; un testnet te donne ce que son carnet veut bien te donner. Chaque champ, avec sa plage →
Les entrées limite, les entrées stop, les stop-loss, les objectifs et les trailing stops sont tous évalués de notre côté sur des bougies 1 minute. Ton bot peut être hors ligne, en redémarrage ou redéployé : l'exécution tombe quand même à ton niveau, horodatée à la minute où le marché l'a réellement atteint.
Les deux jambes paient des frais taker, prélevés en aller-retour à la clôture, avec le funding accumulé au fil des marks. Choisis une plateforme et le compte de paper trading est facturé selon la grille publiée de cet exchange, moins notre réduction de parrainage - donc une stratégie de scalping échoue ici pour la même raison qu'elle échouerait là-bas.
Marge isolée, maintenance à 0.5%, pertes plafonnées à ta marge. Un trailing stop est déplacé par l'extrême de chaque bougie après que cette bougie a été vérifiée contre le stop en vigueur - une barre ne peut donc jamais te stopper à un niveau qu'elle a elle-même créé.
Envoie client_order_id et une ouverture relancée renvoie la position créée par le premier appel, marquée idempotent: true. La clôture en accepte un aussi. Ce seul champ fait la différence entre un bot auquel tu fais confiance sans surveillance et un bot que tu dois surveiller en permanence.
Un WebSocket gratuit pousse les événements de position et le mark price toutes les ~2 s ; les webhooks envoient en POST la même structure à ta propre URL, signée HMAC et avec relances, même quand rien de chez toi n'est connecté. Les ETags rendent quasi gratuits les polls que tu conserves.
Chaque book a son propre journal, sa courbe de capital et son drawdown. /v1/report renvoie le taux de réussite et le rendement par coin, tranche de levier, sens et heure, avec un score de compétence - et il ne dit rien sous huit trades plutôt que d'inventer une tendance.
Vingt-quatre au total. Tout est en JSON via HTTPS, CORS activé, un seul header. Remplace v1 par v2 dans n'importe quel chemin pour obtenir l'enveloppe {ok,data,ts}.
&end=<unix ms> pour remonter plus loin.?dataset=liquidations&day=2026-10-07 renvoie ce jour UTC en CSV gzip, avec son nombre de lignes et son sha256 dans X-MP-Rows / X-MP-Sha256 : chaque liquidation depuis le 24 juillet 2026, agrégats de 5 minutes, open interest par exchange, OI et funding horaires de chaque perp Bybit, trades et positions des baleines Hyperliquid, catalyseurs, ratio long/short et indice MPAD.asset_class, max_leverage et taker_fee_pct par symbole. Filtre avec ?class=crypto|stock|forex|metal|index. Appelle-le une fois au démarrage au lieu de découvrir les limites par tâtonnement.drift_ms. Un bot qui découpe ses bougies selon une horloge locale qui dérive construit des barres que personne d'autre ne voit, et c'est un enfer à déboguer de l'extérieur.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
{"symbol":"BTC","side":"long","margin_usd":100,"leverage":20,"sl":58000,"tp":66000} (sl/tp facultatifs). Renvoie la position avec son liq_price. Ajoute "dry_run":true pour récupérer le trade chiffré - entrée, quantité, prix de liquidation et distance, frais d'ouverture et aller-retour complet - sans rien écrire. Utilise le dry run pour dimensionner une position ou pour tester ton bot contre le vrai moteur.trail_pct place un stop qui suit le meilleur prix atteint depuis l'entrée à cette distance en pourcentage, resserré côté serveur : à partir des extrêmes des bougies de 1 minute lors du balayage de chaque minute et du prix en direct à chaque lecture de /positions, donc il continue d'avancer quand ton bot est hors ligne et ne se desserre jamais. Un long ouvert à 60,000 avec trail_pct: 1 démarre avec son stop à 59,400 ; quand le prix touche 63,000, le stop est à 62,370. Les positions portent trail_pct et trail_hwm.{"symbol":"BTC","side":"long","type":"limit","limit_price":58000,"margin_usd":100,"leverage":20}. Il est exécuté à ton prix, pas au prix auquel le moteur a remarqué le croisement - l'exécution est déterminée à partir du plus haut/plus bas en 1m, donc une mèche revenue entre deux vérifications compte quand même. Ton bot n'a pas besoin de tourner. Un long limite doit être sous le marché et un short limite au-dessus ; sinon tu reçois limit_marketable plutôt qu'une exécution au marché silencieuse.{"symbol":"BTC","side":"long","type":"stop","limit_price":66000,"margin_usd":100,"leverage":10}. Même moteur qu'un ordre limite - il s'exécute au niveau à partir des bougies 1m, navigateur fermé - mais le mauvais côté est refusé (stop_wrong_side) pour qu'un stop et une limite ne puissent jamais être confondus. sl, tp, trail_pct, client_order_id et dry_run s'appliquent tous.{"id":"bp...","pct":50} - pct est optionnel (100 par défaut) ; les clôtures partielles divisent la position exactement comme sur le site.{"id":"bot...","sl":63500,"tp":66000,"trail_pct":1.5} - envoie null pour en effacer un, omets un champ pour le conserver. Les niveaux sont vérifiés par rapport au sens de l'entrée. Avant cela, il fallait clôturer puis rouvrir pour déplacer un stop, ce qui changeait ton entrée et te faisait payer un aller-retour complet.type: "limit" | "stop", plus les 20 derniers exécutés, expirés ou annulés - un ordre exécuté porte le position_id qu'il a créé. Les ordres restent valables jusqu'à annulation, expirent après 30 jours, et 20 peuvent être en attente par compte.{"order_id":"lo...","limit_price":58500,"sl":57000,"tp":62000,"margin_usd":150,"leverage":10,"trail_pct":1} - envoie uniquement ce qui change. Avant, la seule solution était d'annuler puis de replacer, ce qui faisait perdre le client_order_id de l'ordre. Le sens est recalculé à partir du marché actuel et le repère de bougie redémarre, donc un niveau déplacé ne peut jamais être exécuté sur une barre formée avant le changement. Un ordre exécuté, annulé ou expiré répond 409.{"order_id":"lo..."}. Un ordre déjà exécuté ou annulé renvoie 409, donc une nouvelle tentative ne peut jamais défaire une exécution.mark_price et unrealized_pnl_usd en direct ; les liquidations franchies et les SL/TP sont réglés automatiquement. ?status=open|closed réduit le corps à ce que ta boucle lit vraiment ; ?since=<unix ms> et If-None-Match (304 quand rien n'a changé) sont aussi pris en charge.balance_usd, equity_usd, free_margin_usd et return_pct./account quand ta logique de dimensionnement n'a besoin que de ça./positions est plafonné à 100 lignes ; celui-ci parcourt toute la fenêtre de conservation - suis next_before jusqu'à ce qu'il revienne à null. Utilise-le pour calculer les statistiques d'une stratégie sur l'historique complet plutôt que sur une fin tronquée.max_drawdown_pct et le point non réalisé en direct à la fin.{"confirm":true} : clôtures archivées, ordres annulés. Refusé avec 409 open_positions_exist tant que quelque chose est ouvert.usage_30d - les appels par jour et par endpoint plus refused (les 429), pour qu'un bot voie à quel point il frôle sa limite.POST {"venue":"bybit"} définit le choix par défaut du compte ; fee_venue sur /open le remplace pour une position. Voir frais par plateforme.locked[] indique ce qui est masqué). Chaque analyse précise le n sur lequel elle repose et ne dit rien en dessous de 8 trades.POST {"act":"add","url":"https://…"} en enregistre un, {"act":"test","id":…} envoie un ping et renvoie le statut répondu par ton serveur, {"act":"delete","id":…} le supprime.Lisible par les machines : spécification OpenAPI 3.1 avec les schémas complets des requêtes et réponses · une référence interactive d'où tu peux lancer des appels · le changelog (JSON).
Les ordres sont exécutés instantanément au vrai prix en direct (flux multi-exchange - les mêmes prix que notre Paper Trade). Les exécutions API n'ont aucun slippage (celles du site, si), considère donc les prix d'entrée comme légèrement optimistes.
Chaque position paie des frais taker des deux côtés, réglés dans pnl_usd à la clôture. Ils sont facturés comme un aller-retour : fee = qty × (entry + exit) × rate. Le funding s'accumule sur les positions détenues au passage des échéances de funding et se déduit de la même façon. Les positions ouvertes affichent déjà le P&L net de l'aller-retour dans unrealized_pnl_usd, donc ce que tu vois est ce qui sera réglé.
| Marché | Frais par côté | Aller-retour sur $10,000 de notionnel |
|---|---|---|
| Perps crypto | 0.055% | $11.00 |
| Actions & ETF | 0.02% | $4.00 |
| Métaux & indices | 0.015% | $3.00 |
| Paires forex majeures | 0.008% | $1.60 |
Tu préfères la facture exacte de l'exchange sur lequel tu vas tourner ? Facture le compte paper selon sa grille, remise de parrainage incluse. Au-delà d'environ 180× de levier, le taux diminue pour que l'aller-retour ne dépasse jamais 20% de ta marge. GET /v1/markets renvoie le taux exact et le plafond de levier pour chaque symbole. Les stratégies à court horizon vivent ou meurent sur ce chiffre - un scalp qui rapporte moins que l'aller-retour est perdant, peu importe combien de fois il a raison.
Marge isolée. Les pertes sont plafonnées à ta marge. Le prix de liquidation utilise un taux de marge de maintenance de 0.5% ; quand le prix en direct le franchit, la position est réglée automatiquement au prix de liquidation. Les ordres stop-loss et take-profit s'exécutent aussi automatiquement - quand le prix franchit ton sl ou ton tp (vérifié sur les mèches des bougies 1 minute lors du balayage minute, donc un pic qui s'est replié compte quand même), la position est réglée à ce niveau. Un trailing stop suit le meilleur prix atteint : lors du balayage, il est déplacé par l'extrême de chaque bougie après que cette bougie a été vérifiée contre le stop en vigueur, donc une barre ne peut jamais te sortir à un niveau qu'elle a elle-même créé.
Chaque compte paper démarre avec un solde nominal de $10,000. /v1/account et /v1/balance indiquent balance_usd, equity_usd et free_margin_usd pour que tu puisses exprimer tes résultats en rendement plutôt qu'en simple montant en dollars. Ce solde est un tableau de score, pas une contrainte : la marge n'en est pas débitée et une ouverture n'est jamais refusée faute de fonds (margin_enforced: false). Dimensionne tes positions toi-même si tu veux que la contrainte soit réelle.
Chaque réponse contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (secondes epoch) ; un 429 ajoute Retry-After. Les limites sont comptées par clé, donc une deuxième clé a son propre quota. X-RateLimit-Scope indique si c'est la limite de la clé ou celle par IP qui s'est appliquée.
Les positions ouvertes via l'API vivent sur ton compte côté serveur, donc elles apparaissent dans My Trades, comptent pour les classements de saison et l'XP, et alimentent ton Trading Report - le même rapport que GET /v1/report renvoie au bot.
Le mettre derrière un paywall renverrait tout le monde au polling, ce qui nous coûte bien plus cher que le stream - les intérêts sont donc alignés : utilise le WebSocket, tout le monde y gagne. Les données de marché restent sans clé et gratuites pour toujours ; une clé ne fait que relever leur plafond.
Deux choses dans ce moteur sont volontairement généreuses, et mieux vaut les nommer que de te laisser les découvrir sur un compte réel. Un ordre au marché est exécuté au prix en direct, donc une nouvelle position affiche 0.00 de non réalisé et la ligne d'entrée se trouve exactement là où tu l'as demandée. Et la marge de maintenance est fixe à 0.5%, quelle que soit la valeur de la position. Pour apprendre à trader, ce sont les bons choix. Pour valider une stratégie, ils sont optimistes, et plus la taille est grosse, plus ils le sont.
Ce sont donc des interrupteurs, pas des hypothèses. Désactivés par défaut - rien de ce que tu as déjà construit ne bouge - et activés, le prix d'exécution et le prix de liquidation se comportent comme le font un vrai carnet et une vraie grille de limites de risque.
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}
L'exécution bouge contre toi de ce que coûte la traversée d'un vrai carnet d'ordres : 0.01% sur les majeures, 0.05% sur les cryptos moins liquides, 0.005% sur le forex, 0.02% sur les actions, métaux et indices. Un achat paie plus cher, une vente vend plus bas - jamais l'inverse.
La marge de maintenance augmente avec la taille notionnelle, comme dans une table de risk limits d'exchange, donc une grosse position est liquidée plus tôt - une exigence de maintenance plus élevée tolère un mouvement contraire plus faible avant de te clôturer, ce qui est exactement ce que veut une plateforme sur les grosses tailles. C'est notre modèle publié plutôt que la table d'une plateforme en particulier, et GET /realism renvoie toute l'échelle - tu ne devrais jamais avoir à la reconstituer à partir d'un prix de liquidation.
Sur quelle plateforme caler le taux de marge de maintenance publié : Binance 0.40%, Bybit 0.50%, MEXC 0.10%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%. Il ne déplace que le prix de liquidation - jamais la taille, les frais ou le P&L.
Ces trois-là ne sont qu'une partie de l'ensemble. Toute la simulation est configurable - la taille du book et s'il s'agit d'un vrai budget, tes propres chiffres de slippage et de frais, l'impact de taille, la latence, les exécutions partielles, les refus et le funding - et huit presets la règlent en un seul appel. Une position garde la marge de maintenance avec laquelle elle a été exécutée, donc activer ceci ne réécrit jamais un trade que tu détiens déjà, et chaque clôture enregistre les réglages avec lesquels elle a tourné. C'est de là que vient la colonne Exécutions de l'arène - un classement de bots se doit de dire lesquels étaient en mode facile.
Les trois interrupteurs ci-dessus font partie d'un ensemble plus large. Tout ce que suppose ce moteur est un champ que tu peux régler : la taille du book et s'il s'agit d'un vrai budget, ce que coûte la traversée du carnet d'ordres à l'entrée et à la sortie, combien de temps ton ordre est en transit, si un ordre s'exécute partiellement, à quelle fréquence la plateforme dit non, ce que tu paies en frais, si le funding est facturé ou non, et où se situe le prix de liquidation.
Les réglages par défaut sont volontairement faciles, et autant le dire clairement. Un ordre au marché est exécuté en entier au prix en direct, la marge de maintenance est fixe à 0.5%, le solde est un simple tableau de score qui ne refuse jamais une ouverture, et il n'y a ni latence ni impact de taille. C'est le bon endroit pour faire tourner un bot. C'est le mauvais endroit pour juger s'il a un vrai avantage. Un seul appel change tout ça.
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"}
Les valeurs hors plage sont refusées, jamais plafonnées - une stratégie ne doit jamais être mesurée avec un réglage que tu n'as pas choisi. Une position conserve à vie la marge de maintenance, le taux de frais et le coût de traversée en sortie avec lesquels elle a été exécutée ; activer quoi que ce soit ne réécrit jamais un trade que tu détiens déjà.
Le moteur tel qu'il a toujours été. Fais tourner le bot, regarde les trades arriver, puis modifie-le.
Celui sur lequel mesurer un edge : le carnet coûte ce que nous mesurons sur les deux jambes, la taille coûte plus cher, l'échelle de limites de risque est active, le funding est prélevé, et le carnet refuse ce qu'il ne peut pas financer.
Les frais taker et la marge de maintenance publiés par cette plateforme, avec notre coût de traversée mesuré, la marge appliquée et l'échelle activée.
Un perp mid-cap à une heure défavorable, puis pire que tout ce que tu rencontreras : 60 bps pour traverser, 120 bps par tranche de $100k de taille, des exécutions à partir d'un quart, une ouverture sur vingt refusée, une seconde de latence. Ce sont nos chiffres, pas ceux d’une plateforme. Si une stratégie fonctionne encore ici, elle ne vit pas de la chance d'exécution.
| Champ | Plage | Ce que ça fait |
|---|---|---|
| Le book — ce que le bot a le droit de risquer | ||
start_balance_usd | 100 – 10,000,000 | Le book à l'aune duquel tes résultats sont mesurés : return_pct, la courbe de capital et le drawdown maximal en dépendent. Teste avec la taille de compte que tu vas vraiment trader. |
margin_enforced | désactivé / activé | La plus grande différence entre un tableau de score et une vraie plateforme. Une fois activé, une ouverture qui demande plus que ta marge libre est refusée avec 402 insufficient_margin. La marge libre, c'est le solde moins la marge engagée — le profit non réalisé d'une position ouverte ne sert pas de collatéral pour une nouvelle, car chaque position ici est en marge isolée. |
leverage_max | 0 – 10,000 | Ton propre plafond, sous celui du marché. Prouve qu'une stratégie n'a jamais dérivé discrètement vers du 100×. 0 = le plafond du marché. |
max_notional_usd | 0 – 1,000,000,000 | Ton propre plafond sur le notionnel d'une position. 0 = aucun plafond personnel. |
| L'exécution — ce que coûte la traversée du carnet | ||
slippage | désactivé / activé | Des exécutions à ton désavantage, comme lors de la traversée d'un vrai carnet : 0.01% sur les majeures crypto, 0.05% sur les cryptos moins liquides, 0.005% sur le forex, 0.02% sur les actions, métaux et indices. Un achat paie plus cher, une vente vend plus bas. |
slippage_bps | 0 – 500 | Ton propre chiffre à la place de ce tableau. 10 = 0.10%. null revient au tableau. |
impact_bps_per_100k | 0 – 500 | La taille coûte plus cher, car un ordre plus gros descend plus loin dans le carnet : ce nombre de points de base en plus par tranche de $100,000 de notionnel. |
exit_slippage | activé / désactivé | Paie le coût de traversée à la sortie comme à l'entrée. Sans cela, une stratégie de scalping paraît meilleure qu'elle ne pourra jamais l'être en réel. Un stop, un take-profit ou une liquidation s'exécute toujours à son propre niveau — vois les limites ci-dessous. |
latency_ms | 0 – 2,000 | Ton ordre est en transit pendant cette durée, et le prix est relu ensuite — l'exécution reflète donc le marché au moment où ton ordre est arrivé, pas quand tu l'as envoyé. |
partial_fills | désactivé / activé | Un ordre au marché peut être exécuté pour moins que demandé. La taille exécutée est position.margin_usd ; le ratio figure dans le header X-MP-Fill-Pct et dans l'objet fill en v2. |
min_fill_pct | 10 – 100 | Le pire ratio que tu puisses recevoir. 40 signifie entre 40% et 100% de ce que tu as demandé. |
reject_rate_pct | 0 – 50 | Cette part des ouvertures est volontairement refusée en 503 venue_rejected. Un bot qui ne sait pas gérer un refus n'est pas terminé, et c'est ici qu'on le découvre à moindre coût. |
| Le coût | ||
taker_bps | 0 – 100 | Tes propres frais par côté au lieu de la grille d'une plateforme. 5.5 = 0.055%. La dégressivité selon le levier s'applique toujours, donc aucun réglage ne peut faire qu'un aller-retour mange toute la mise. |
funding | activé / désactivé | Désactivé, le funding n'est jamais prélevé. C'est ainsi qu'on distingue un edge d'exécution d'un edge de portage — un short tenu pendant un funding positif peut n'être rentable que grâce au funding. |
funding_mult | 0 – 5 | Applique un multiple au vrai taux sur 8 heures. |
| La liquidation | ||
margin_venue | 10 plateformes | La plateforme dont le taux de marge de maintenance publié détermine où se situe la liquidation. Binance 0.40%, Bybit 0.50%, MEXC 0.10%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%. Il ne déplace que le prix de liquidation. |
margin_tiers | désactivé / activé | La marge de maintenance augmente avec le notionnel, comme une échelle de risk limits, donc une grosse position est liquidée plus tôt. Toute l'échelle est publiée dans GET /v2/realism. |
mmr_pct | 0.05 – 10 | Ta propre marge de maintenance, prioritaire sur margin_venue et sur notre valeur par défaut. |
Un stop-loss, un take-profit ou une liquidation s'exécute à son propre niveau et ne paie jamais le coût de traversée : le balayage côté serveur passe sur tous les comptes à la fois et ne peut pas lire un profil à chaque passage. Il n'y a pas de carnet d'ordres avec une vraie profondeur derrière le modèle d'impact — impact_bps_per_100k est un coût linéaire déclaré, pas un carnet simulé. Et tout le coût de traversée à la sortie est facturé par rapport au mark price, ce qui revient à un seul spread, pas à un bid et un ask que tu pourrais coter séparément. Tout le reste ci-dessus est appliqué exactement comme écrit.
Chaque chiffre de ce profil peut être relu via GET /api/bot/v2/sim, y compris ce à quoi ressemblerait une exécution maintenant — un chiffre qu'un bot ne peut pas relire est un chiffre qu'il doit deviner. GET /api/bot/v2/report te dit ensuite ce que l'exécution a vraiment coûté : frais, funding, brut contre net, et kept_pct, la part du brut qui a survécu. Celui-là est gratuit sur tous les plans, car il ne détaille pas où se trouve ton avantage — il dit si cet avantage est réel.
Par défaut, chaque exécution paper paie le taux MarginPad : 0.055% par côté sur la crypto, sur les deux jambes, facturé comme un aller-retour à la clôture. C'est une moyenne honnête, mais ce n'est la facture exacte de personne. Si tu sais déjà où le bot tournera pour de vrai, facture le compte paper selon la grille de cette plateforme - son taux taker publié, moins la remise de parrainage qu'y obtient une inscription via MarginPad - pour que le test en conditions réelles se règle comme le fera le compte réel :
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
| Plateforme | Taker | Notre réduction de parrainage | Tu paies par côté |
|---|---|---|---|
| Bybit | 0.055% | 20% | 0.044% |
| Binance | 0.050% | 20% | 0.040% |
| Bitget | 0.060% | 20% | 0.048% |
| Gate | 0.050% | 20% | 0.040% |
| Hyperliquid | 0.045% | 4% (code MARGINPAD) | 0.0432% |
| OKX · Kraken | 0.050% | - | 0.050% |
| MEXC | 0.020% | - | 0.020% |
| KuCoin | 0.060% | - | 0.060% |
| Par défaut MarginPad | aucune plateforme choisie | 0.055% | |
Les taux sont le palier de base publié par chaque plateforme et les réductions que nous indiquons sur /exchanges/ ; l'API les renvoie avec source pour que tu saches que ce sont des chiffres annoncés, pas des mesures. Les deux jambes paient le taux taker (le moteur de paper trading exécute au marché ; une remise maker sur une entrée en attente n'est pas modélisée). Perps crypto uniquement - actions, forex, métaux et indices gardent les taux MarginPad de leur classe, quelle que soit la plateforme. Les positions ouvertes gardent le taux auquel elles ont été exécutées ; le plafond pour levier extrême (un aller-retour jamais au-dessus de 20% de la marge) s'applique toujours. Le même choix est le sélecteur "Frais comme sur" du formulaire Paper Trade, donc un bot et les trades manuels de son propriétaire paient exactement les mêmes frais.
Envoie toujours client_order_id à l'ouverture. C'est la ligne la plus importante de cette documentation. Sans lui, une requête qui expire sur le réseau te laisse dans le doute : la position s'est-elle ouverte ou non ? Réessaie et tu risques d'en avoir deux. Avec lui, la nouvelle tentative renvoie la position créée par le premier appel, marquée 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}}
Utilise une valeur que ta stratégie peut régénérer de façon déterministe - un id de signal, ou le symbole plus l'horodatage de la bougie. Les ids sont mémorisés 7 jours.
La clôture en accepte un aussi. Envoie client_order_id sur /close et une nouvelle tentative indique ce qu'a fait le premier appel (idempotent: true) au lieu d'une erreur à interpréter.
Envoie symbol quand tu clôtures. Chaque ligne de /positions le contient déjà, c'est donc gratuit à ajouter et ça raccourcit nettement la clôture :
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
Notre store de trading est une instance unique rattachée à une région, donc chaque saut supplémentaire coûte ce que coûte l'aller-retour jusqu'à elle depuis l'endroit où tu te trouves. Mesuré le 2026-08-19 : environ 20 ms depuis l'Europe mais 198 ms en médiane et 368 ms au 95e percentile depuis Singapour. Un flux de prix à froid ajoute environ 400 ms, et sans l'indication, une clôture sur une paire liquide pourrait finir par attendre une paire illiquide du même lot. Avec l'indication, une clôture se résume à un saut plus un prix déjà chaud. Un symbol erroné ou périmé ne coûte rien - le serveur s'en aperçoit et se rabat sur la méthode normale.
Ne grille pas ton budget de requêtes en polling. La plupart des bots passent l'essentiel de leurs appels à demander « est-ce que quelque chose a changé ». Deux choses rendent cela quasi gratuit :
# 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
L'ETag couvre l'état structurel - ids de position, statut, quantité, stop, objectif, sortie - et volontairement pas le mark price, qui bouge à chaque tick et empêcherait l'ETag de jamais correspondre. Donc : fais du polling sur /positions pour savoir « mon stop s'est-il déclenché », et sur /price sans clé pour le P&L. Surveille X-RateLimit-Remaining et ralentis selon Retry-After.
Positions et prix te sont poussés, donc tu sais en quelques secondes que ton stop s'est déclenché au lieu de l'apprendre à ton prochain 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"}
Événements : position avec event: opened | updated | closed se déclenche quand quelque chose change vraiment - une exécution, un stop déplacé, une clôture, une liquidation. prices transporte le mark price de tes symboles ouverts à chaque tick. Un mouvement du mark price seul ne déclenche jamais d'événement position, donc le canal reste silencieux quand rien ne s'est passé.
Les stops se règlent plus vite quand tu es connecté. Le stream pilote le même balayage SL/TP/liquidation côté serveur que le chemin REST, à sa cadence d'environ 2s, au lieu de laisser ta position au balayage périodique.
Jusqu'à 3 sockets simultanés par compte, partagés entre tes clés. Les sockets sont recyclés au bout de 6 heures - reconnecte-toi et tu reçois un nouveau snapshot. Si la connexion tombe, considère le snapshot suivant comme la vérité plutôt que de rejouer les événements manqués.
Mesuré sur les 40 derniers jours : 76.4% de tous les appels à cette API sont des polls de /positions et /account à la recherche d'événements qui ne se sont pas encore produits. Un webhook inverse la logique - on t'envoie un POST quand quelque chose se produit vraiment, avec la même structure Position qu'aurait renvoyée un poll, et ça fonctionne même quand ton bot est hors ligne, en redémarrage ou déployé quelque part qui ne peut pas maintenir un socket.
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",…}}
Événements : position.opened · position.updated (un stop ou un objectif déplacé) · position.closed · position.liquidated · order.filled (contient la position créée) · order.expired · order.cancelled. Omets events pour tous les recevoir. Les trades passés depuis le site sur le même compte les déclenchent aussi.
Vérifie chaque envoi. X-MP-Signature vaut sha256=HMAC_SHA256(secret, raw body), avec le secret renvoyé quand tu as ajouté le hook. Compare-la avant de parser le corps ; les deux SDK fournissent verify_webhook / verifyWebhook. Réponds en 2xx en moins de 6 secondes - sinon l'envoi est retenté 5 fois avec un backoff (30 s, 1, 2, 4 min), et un hook est mis en pause après 25 échecs consécutifs ; GET /webhooks affiche active, consecutive_failures et last_error pour que tu voies pourquoi. 15 hooks par compte avec API Premium ; les envois sont fournis au mieux, le snapshot WebSocket et /positions restent la source de vérité.
Essaie avant d'écrire un récepteur : enregistre https://marginpad.io/api/whsink/<any-token-you-choose> comme URL, puis fais un GET sur cette même adresse - elle renvoie les 20 dernières livraisons (headers et corps) pendant 15 minutes. Sans authentification ; le token fait office de secret.
Un book est un journal, un solde, un rapport et une courbe d'equity distincts au sein de ton compte. Crée une clé avec un nom de book et chaque appel fait avec cette clé trade sur ce book ; ton compte principal et tes autres books ne le voient jamais. Les comptes gratuits ont un book en plus du compte principal, API Premium en a 20.
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
Le reset est refusé avec 409 open_positions_exist tant que quelque chose est ouvert : clôture d'abord, puis réinitialise. Les trades archivés sont conservés (jamais supprimés), mais le rapport, le grand livre, /trades et la courbe de capital repartent du reset, et un navigateur qui détient encore l'ancien journal ne peut pas le renvoyer. Les webhooks se déclenchent sur les hooks du compte avec "account":"rsi" dans le payload, donc un seul récepteur sert tous les books.
Backteste avec le code que tu feras tourner en réel. Lance le replay d'une journée UTC passée et les routes que ton bot appelle déjà agissent sur un journal de replay séparé, valorisé à partir des propres bougies 1 minute de MarginPad à la position du curseur. Stops, objectifs et liquidations sont vérifiés sur chaque bougie entre deux de tes appels, sur le plus haut et le plus bas, avec les mêmes calculs de frais et de funding qu'en réel. Rien d'un replay n'atteint les classements, l'arène ou ton rapport.
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
La vitesse va de 1 (temps réel) à 600 (une journée en 2.4 minutes). Un seul replay par clé à la fois, crypto uniquement, ordres au marché uniquement pour l'instant : lis le prix et les bougies du replay depuis GET /v1/replay, car /v1/price et /v1/klines sans clé continuent de renvoyer les données en direct.
Tu peux avoir plusieurs clés sur un même compte - sépare un bot de backtest d'un bot en réel, et révoque-en une sans toucher à l'autre. L'utilisation et les limites de requêtes sont comptées par clé, donc chacune a son propre budget et sa propre ligne dans tes stats. Connecté sur le site, depuis le navigateur :
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
Une clé révoquée renvoie 401 revoked_key. Les clés sont secrètes - quiconque en détient une peut trader ton compte paper. Crée-les et révoque-les en haut de cette page.
Chaque compte ou book ayant au moins cinq clôtures de trades ouverts via l'API pendant cette saison de 14 jours est classé sur /arena/ selon le P&L réalisé net de frais et de funding, avec le taux de réussite, le rendement sur le tableau de score de $10,000, le ROE moyen et les liquidations. Pas de prix et aucune inscription : trade via l'API et le classement te prend en compte. JSON : GET /api/arena.
MarginPad fait tourner un serveur MCP distant, pour qu'un assistant IA puisse lire les marchés et trader ton compte de paper trading directement - sans code d'intégration :
https://marginpad.io/mcp
Ajoute-le comme serveur MCP distant dans ton client et définis l'en-tête X-API-Key: mpb_… si tu veux les outils de paper trading. Les outils de données de marché n'ont pas besoin de clé. Vingt-huit outils sont exposés : prix, bougies, marchés, screener, funding, open interest, liquidations, peur et avidité, le calendrier économique, deux calculateurs, et en paper trading open (avec trailing stops et dry run) / ordres limite et stop / modify / cancel / close / sltp / positions / orders / balance / trades / report / fees / accounts / reset / equity / replay. GET /mcp dans un navigateur renvoie le descripteur du serveur.
/api/bot/v1/* est figé. Ses corps de réponse ne changeront pas ; les bots écrits pour lui continuent de fonctionner indéfiniment, et il reçoit toujours les corrections d'exactitude.
/api/bot/v2/* est la même API avec l'enveloppe qu'utilisent déjà nos endpoints de données - une forme prévisible en cas de succès comme d'échec, pour n'écrire le parsing qu'une fois :
{ "ok": true, "data": { ... }, "ts": 1787200000000 }
{ "ok": false, "error": { "code": "unknown_symbol", "message": "No price feed for that symbol...", "symbol": "FOO" }, "ts": 1787200000000 }
Mêmes chemins, mêmes paramètres, même clé - remplace v1 par v2 dans l'URL. Les valeurs code des erreurs sont des identifiants stables ; message s'adresse aux humains et peut être reformulé.
Sur /v2, les échecs sont toujours {"ok":false,"error":{"code","message"},"ts"}. Le code est un identifiant stable sur lequel tu peux brancher ta logique ; le message est en prose et peut être reformulé. Certaines erreurs contiennent la valeur dont tu as besoin pour corriger l'appel - sl_wrong_side et tp_wrong_side incluent le prix en direct.
| Code | HTTP | Que faire |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Envoie une clé valide dans X-API-Key. |
revoked_key | 401 | Crée une nouvelle clé ; celle-ci a été révoquée. |
rate_limit | 429 | Attends jusqu'à Retry-After. Ne relance pas immédiatement. |
unknown_symbol | 404 | Vérifie /v1/markets. |
symbol_required, margin_usd_min_1, margin_usd_max_100000, id_required | 400 | Corrige le corps de la requête. |
sl_wrong_side / tp_wrong_side | 400 | La réponse contient live - place le niveau du bon côté de ce prix. |
stop_wrong_side | 400 | Une entrée stop attend du côté de la cassure (long au-dessus, short en dessous). Utilise type:"limit" pour une entrée sur repli. |
trail_pct_invalid | 400 | trail_pct est un pourcentage entre 0.05 et 50 ; une valeur hors plage est refusée, jamais plafonnée en silence. |
nothing_to_modify | 400 | /modify_order nécessite au moins un champ. |
plan_required | 402 | Les webhooks nécessitent un plan payant. Tout le reste de cette page est sur Free. Le corps contient plan_needed. |
premium_required | 402 | Ancien code de plan_required, toujours envoyé pour qu'un bot 2.3 le reconnaisse. |
too_many_webhooks | 409 | Supprime-en un d'abord - 15 hooks avec API Premium. |
bad_url / bad_event | 400 | Les URL de webhook sont en https sur un hôte public ; les noms d'événements sont listés dans GET /webhooks. |
too_many_open | 409 | Tu as atteint le plafond de positions ouvertes de ton plan. Clôture quelque chose. |
already_closed | 400 | Sans danger lors d'une nouvelle tentative - la position est déjà réglée. |
no_price | 400 | Pas de prix en direct à cet instant ; la position reste ouverte. Réessaie. |
unavailable | 503 | Transitoire. Réessaie avec un backoff. |
Toujours bloqué ? Le corps de l'erreur est le premier endroit où regarder, et la page status le second. Si aucun des deux ne répond, écris à support@marginpad.io avec l'endpoint et le corps exact qu'on t'a renvoyé - ce qu'il faut ajouter est indiqué sur la page support. Une vraie personne le lit.
Liquidations en temps réel agrégées depuis douze exchanges par notre propre collecteur - les données derrière notre flux Rekt et notre heatmap de liquidations, exposées en JSON gratuit. Ailleurs, des données comparables sont généralement derrière un paywall à $300+/mois ; ici, aucune clé API n'est nécessaire. Mises en cache en edge et soumises à une limite de requêtes, elles encaissent sans peine les bots qui font du polling.
{events:[{ts, exchange, symbol, side, price, qty, notional}]}. Les événements arrivent ici quelques secondes après s'être produits (cache edge de 3s). Fais du polling toutes les 3-5s.side vaut long_liquidated ou short_liquidated, notional est la taille en USD.minutes : jusqu'à 43200 (30 jours).{clusters:[{price, side, est_notional}]}. Mis à jour en continu à partir du flux d'ordres en direct.Mention appréciée (lien vers marginpad.io) mais pas obligatoire. La couverture représente ~70%+ du flux de liquidations du marché - les plateformes qui font bouger le prix. Usage pédagogique ; aucun SLA de disponibilité. Tu veux juste des données de marché ? Toute la surface sans clé est documentée sur la page API de données crypto gratuite.
La plupart des bots de trading crypto qui semblent rentables en backtest perdent de l'argent dès leur première semaine en réel. Les backtests rejouent des bougies historiques propres - ils ne peuvent pas détecter une race condition dans ta logique d'ordres, un bug de dimensionnement qui n'apparaît qu'après une série de pertes, ou un levier qui grimpe discrètement au-delà de ce que ta marge peut encaisser. Le forward testing fait tourner le même bot, le même chemin de code, sur de vrais prix en direct, en temps réel. Si la stratégie a un défaut, il apparaît ici, là où un bug ne te coûte rien.
| Backtesting | Paper trading (cette API) | Trading réel | |
|---|---|---|---|
| Prix | Bougies historiques | Vrais prix en direct, en temps réel | Vrais prix en direct |
| Risque | Aucun | Aucun - des dollars simulés | Argent réel en jeu |
| Détecte les bugs de logique | Rarement - les données rejouées les masquent | Oui - même chemin de code qu'en direct | Oui, mais chaque bug coûte de l'argent |
| Contrôle du surapprentissage | Non - tu as réglé ta stratégie sur ces données | Oui - des données futures jamais vues | Oui |
| Coût | Gratuit | Gratuit - frais & funding simulés | Frais + pertes + funding |
| Idéal pour | Filtrer les idées rapidement | Prouver le bot avant d'y mettre de l'argent | Une stratégie déjà validée deux fois |
L'étape du milieu est celle que la plupart des gens sautent - et celle qui les aurait sauvés. Backteste une idée ici, teste-la en conditions réelles sur cette API, puis alimente un compte.
Tout ce qui se trouve sur cette page se règle en dollars simulés. Une fois que le bot a survécu à des semaines de forward testing, le même code a besoin de l'API d'un exchange pour passer de vrais ordres. Deux plateformes vers lesquelles nous orientons les créateurs de bots, pour des raisons différentes :
Des perps sur leur propre chaîne avec une API REST et WebSocket publique, des sous-comptes qui ont chacun leur propre wallet API (le bot ne détient jamais ta clé principale), un funding horaire et un carnet que tout le monde peut auditer on-chain. Ce qui se rapproche le plus de cette API, mais avec de l'argent réel.
Des formats REST et WebSocket proches de ce que tu viens d'écrire, une clé distincte par sous-compte, et l'un des flux d'où viennent nos propres prix. Le choix par défaut si tu veux un carnet centralisé avec des rampes d'accès en monnaie fiat.
Ouvrir un compte Bybit →Oui - MarginPad expose gratuitement en JSON les liquidations en temps réel agrégées de 12 exchanges, sans clé : /api/v1/feed, /api/v1/liquidations/live, /api/v1/liquidations/recent et /api/v1/clusters. Les flux comparables coûtent généralement $300+/mois. Vois la section données de liquidation.
Oui. C'est un simulateur de paper trading - les positions utilisent les vrais prix du marché en direct, mais pas d'argent réel. Connecte-toi avec un e-mail, génère une clé API et teste tout de suite, sans limite de durée et sans carte. API Premium ajoute notre archive de marché, le carnet d'ordres brut et les webhooks pour construire dessus.
N'importe quel langage capable de faire une requête HTTPS - Python, JavaScript/Node.js, Go, Rust, PHP, ou simplement curl. REST standard, réponses JSON, un seul header X-API-Key.
N'importe quelle paire USDT avec un prix en direct sur les grands exchanges - BTC, ETH, SOL et des centaines d'altcoins, plus les actions américaines, les paires forex majeures, les métaux et les indices en perps. Vérifie un symbole avec GET /api/bot/v1/price?symbol=SOL.
Non. Pas de dépôt, pas de wallet, pas de KYC. Tu te connectes seulement avec un email pour que ta clé API et tes positions soient conservées d'une session à l'autre.
Non. La Bot API a ses propres plans et un abonnement Premium ne change aucune limite de l'API. Premium débloque des fonctionnalités sur le site ; les plans API débloquent les limites de l'API. Ils s'achètent séparément.
Construis un bot fonctionnel en Python et branche-le sur cette API - code complet : flux de prix, stratégie de croisement d'EMA, ordres d'ouverture/clôture et la boucle.
Le même bot en JavaScript - code Node.js complet sans aucune dépendance, branché sur cette API.
Le processus en trois étapes qui sépare les bots qui fonctionnent des comptes qui explosent : backtest, paper trading, puis réel.
Comment fonctionnent les bots de grid, où ils gagnent et où ils explosent, et comment en tester un en conditions réelles avant d'y mettre de l'argent.
Ce que prouve chaque étape de test, et l'ordre exact dans lequel les enchaîner.
Les stratégies assistées par IA qui tiennent vraiment la route - et comment les tester sans risque avant de les automatiser.