API de paper trading crypto gratuite - teste ton bot de trading | MarginPad
MARGINPAD
Prix en direct · exécutions côté serveur · sans dépôt

L'exchange que ton bot peut se permettre de casser.

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.

marginpad.io/api/bot/v1en direct
# no key needed - run this right now
curl "https://marginpad.io/api/bot/v1/price?symbol=BTC"

{ "symbol": "BTC", "price": …, "ts": … }
POST /openexemple
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 } }

Obtiens ta clé

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.

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.

Plans

Le gratuit suffit pour tester un bot. API Premium sert à construire dessus.

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.

Free

$0 pour toujours

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.

Teste une stratégie de bout en boutun book · un journal · tout le moteur
  • 3 clés · 50 positions ouvertes · 120 req/min
  • Moteur complet : ordres au marché, limite & stop, trailing stops, dry run, replay
  • La simulation configurable - frais, slippage, latence, exécutions partielles - et 9 vrais exchanges
  • Flux WebSocket · MCP · données de marché en direct sans clé
  • Trading Report : totaux, score de compétence et ce que te coûtent les frais et le funding
  • 30 jours d'historique de trades

API Premium

CONSTRUIS DESSUS
$11.99/mois

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.

L'archive de marché, via l'APIchaque liquidation depuis juillet 2026 · open interest · funding · trades de baleines · long/short
  • Archive de marché sur /v1/history - 9 datasets, un CSV vérifié par jour UTC
  • Carnet d'ordres brut par exchange
  • 20 books · 15 webhooks signés
  • 90 jours d'historique de trades, détail des rapports et analyses écrites
  • 30 clés · 500 positions ouvertes · 2000 req/min
Ce qui change selon le planFreeAPI Premium · $11.99
Archive de marché /v1/history
liquidations, agg5m, oi, funding_oi, whale_fills, whale_pos, catalysts, longshort, mpad
le cataloguechaque jour, chaque dataset
Carnet d'ordres brut par exchangecarnet consolidé uniquementoui
Books - un journal, un solde et un rapport distincts par stratégie120
Webhooks - signés, avec relances, livrés même quand tu es hors ligneaucun15
Historique de trades conservé
ce que /v1/trades, le rapport et la courbe d'equity peuvent encore voir
30 jours90 jours
Trading Report /v1/reporttotaux, score de compétence, coûts+ détails & constats
Clés API · positions ouvertes3 · 5030 · 500
Requêtes par minute, par clé (moteur et /api/v1/* avec la clé)
60 / min par IP sans clé, sur tous les plans
1202000

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.

Démarrage rapide

Trois appels, de zéro à une position en direct

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.

ÉTAPE 01

Lire le marché

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.

ÉTAPE 02

Ouvrir une position

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.

ÉTAPE 03

Laisse-le pousser les données, ne fais pas de polling

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}'

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.

26
endpoints, plus un WebSocket, des webhooks et un serveur MCP
9
vraies grilles de frais de plateformes applicables à tes exécutions
1,000×
levier maximal, sur n'importe quelle paire USDT avec un prix en direct
156
marchés sur une seule clé : perps crypto, actions US, forex, indices et métaux
4.4M
appels servis aux bots qui y tournent déjà
ÉTAT store de trading collecteur de liquidations tâches planifiées lecture de /api/status… État complet et historique →
Pourquoi pas le testnet d'un exchange

Un testnet te donne de faux prix. Ici, tu as de vrais prix et de l'argent fictif.

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.

Simulation

Reproduis la plateforme sur laquelle tu vas vraiment trader

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 →

Exécution

Le serveur garde tes ordres

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.

Coûts

Des frais qui collent à ta vraie facture

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.

Échec

Une liquidation qui se comporte normalement

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éé.

Idempotence

Un timeout n'a rien de mystérieux

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.

Observabilité

Push, pas de polling

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.

Mesure

Il note ta stratégie

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.

Endpoints

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}.

Données de marché - sans clé
GET/v1/price?symbol=BTCPrix en direct de n'importe quelle paire USDT. Aucune clé nécessaire - essaie-le tout de suite dans ton navigateur.
GET/v1/klines?symbol=BTC&interval=60Bougies OHLC pour ta stratégie (intervalles : 1, 5, 15, 30, 60, 240, 1440 minutes). Aucune clé requise. Jusqu'à 1000 bougies par appel, la plus récente en dernier - environ 16 heures en 1m, 3 jours en 5m, 10 jours en 15m, 41 jours en 1h, 166 jours en 4h et à peu près 3 ans en 1d. Passe &end=<unix ms> pour remonter plus loin.
GET/v1/historyL'archive de marché (API Premium). Sans paramètre, elle liste chaque dataset, ses colonnes et le premier et le dernier jour archivés - lecture gratuite avec n'importe quelle clé. ?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.
GET/v1/marketsTout ce qui se trade, avec 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.
GET/v1/time?client_ts=…Horloge du serveur. Aucune clé nécessaire. Passe ton propre unix ms et tu récupères 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
Trading
POST/v1/openOuvre une position simulée au prix en direct. Corps : {"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.
POST/v1/open trail_pcttrail_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.
POST/v1/open type:"limit"L'ordre reste en attente sur le serveur au lieu d'être exécuté tout de suite : {"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.
POST/v1/open type:"stop"Une entrée sur cassure : un long au-dessus du marché ou un short en dessous, par ex. {"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.
POST/v1/closeClôture une position au prix en direct. Corps : {"id":"bp...","pct":50} - pct est optionnel (100 par défaut) ; les clôtures partielles divisent la position exactement comme sur le site.
POST/v1/close_allBouton panique - clôture toutes les positions ouvertes au prix en direct en un seul appel.
POST/v1/sltpDéplace le stop-loss, le take-profit ou le trailing stop d'une position ouverte sans la clôturer. Corps : {"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.
Ordres en attente
GET/v1/ordersTes ordres en attente, chacun avec 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.
POST/v1/modify_orderModifie un ordre en attente sur place : {"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.
POST/v1/cancel_orderAnnule un ordre en attente. Corps : {"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.
Compte et état
GET/v1/positions?status=openToutes tes positions avec 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.
GET/v1/accountRésumé du compte : positions ouvertes, marge utilisée, P&L non réalisé en direct, P&L réalisé depuis la création, gains/pertes, taux de réussite, plus balance_usd, equity_usd, free_margin_usd et return_pct.
GET/v1/balanceJuste l'argent : solde de départ, solde, equity, marge utilisée, marge libre, P&L non réalisé. Moins coûteux que /account quand ta logique de dimensionnement n'a besoin que de ça.
GET/v1/trades?limit=100&before=…Le registre complet des trades clôturés, avec pagination. /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.
GET/v1/accountsChaque book du compte avec ses chiffres depuis sa création et les clés qui y sont liées.
GET/v1/equity?days=30&step_min=60La courbe de capital de ce book, par intervalles, avec max_drawdown_pct et le point non réalisé en direct à la fin.
POST/v1/resetRemet ce book à $10,000 avec {"confirm":true} : clôtures archivées, ordres annulés. Refusé avec 409 open_positions_exist tant que quelque chose est ouvert.
GET/v1/usageTon plan, tes plafonds, ce qui reste dans la fenêtre en cours, et 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.
Coûts, intelligence et livraison
GET/v1/feesLa grille de frais appliquée à tes exécutions : les plateformes que nous modélisons avec taker, maker, notre réduction de parrainage et le taux effectif, plus ton choix par défaut actuel. 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.
GET/v1/report?days=30Le Trading Report du compte lié à la clé, mesuré sur ses propres trades clôturés : totaux et score de compétence sur tous les plans ; taux de réussite et rendement par coin, tranche de levier, côté, heure et jour, plus les analyses écrites avec API Premium (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.
GET/v1/webhooksAPI PROLes événements de trading poussés vers ton URL, quelques secondes après qu'ils se produisent, que ton bot soit connecté ou non - vois webhooks. 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.
POST/v1/replay2.6Fais tourner ton bot sur une journée UTC passée avec nos propres bougies 1 minute - vois replay.

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).

Comment fonctionne le moteur

Exécutions et prix

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.

Frais de trading - lis ceci avant de mesurer une stratégie

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 crypto0.055%$11.00
Actions & ETF0.02%$4.00
Métaux & indices0.015%$3.00
Paires forex majeures0.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, liquidation, SL/TP, trailing

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éé.

Solde et equity

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.

En-têtes de limite de requêtes

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 trades de ton bot sur le site

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.

L'API de streaming est gratuite, et c'est voulu

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.

Réalisme des exécutions, car un backtest qui te flatte ne vaut rien

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}

Slippage

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.

Paliers de marge

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.

Plateforme de marge

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.

Reproduis la plateforme sur laquelle tu vas vraiment trader

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à.

Huit préréglages, pour ne pas avoir à inventer dix-huit chiffres

sans friction

Le moteur tel qu'il a toujours été. Fais tourner le bot, regarde les trades arriver, puis modifie-le.

réaliste

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.

binance · bybit · okx · hyperliquid

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.

thin_book · brutal

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.

Chaque champ, sa plage et ce qu'il change

ChampPlageCe que ça fait
Le book — ce que le bot a le droit de risquer
start_balance_usd100 – 10,000,000Le 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_enforceddé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_max0 – 10,000Ton 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_usd0 – 1,000,000,000Ton propre plafond sur le notionnel d'une position. 0 = aucun plafond personnel.
L'exécution — ce que coûte la traversée du carnet
slippagedé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_bps0 – 500Ton propre chiffre à la place de ce tableau. 10 = 0.10%. null revient au tableau.
impact_bps_per_100k0 – 500La 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_slippageactivé / 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_ms0 – 2,000Ton 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_fillsdé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_pct10 – 100Le pire ratio que tu puisses recevoir. 40 signifie entre 40% et 100% de ce que tu as demandé.
reject_rate_pct0 – 50Cette 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_bps0 – 100Tes 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.
fundingactivé / 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_mult0 – 5Applique un multiple au vrai taux sur 8 heures.
La liquidation
margin_venue10 plateformesLa 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_tiersdé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_pct0.05 – 10Ta propre marge de maintenance, prioritaire sur margin_venue et sur notre valeur par défaut.

Ce que ceci ne modélise pas, annoncé plutôt que découvert

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.

Des frais comme sur l'exchange que tu utiliseras vraiment

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
PlateformeTakerNotre réduction de parrainageTu paies par côté
Bybit0.055%20%0.044%
Binance0.050%20%0.040%
Bitget0.060%20%0.048%
Gate0.050%20%0.040%
Hyperliquid0.045%4% (code MARGINPAD)0.0432%
OKX · Kraken0.050%-0.050%
MEXC0.020%-0.020%
KuCoin0.060%-0.060%
Par défaut MarginPadaucune plateforme choisie0.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.

Écrire un bot qui ne casse pas

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.

WebSocket - arrête complètement le polling

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.

Webhooks - des événements poussés vers ton serveur API PRO

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.

Books - une stratégie, un résultat propre 2.5

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.

Replay - fais tourner ton bot sur une journée passée 2.6

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.

Gérer tes clés

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.

Bot arena - un classement public pour les bots

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.

Utilise-le depuis Claude, ChatGPT ou Cursor

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.

Format de réponse - v1 et v2

/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é.

Codes d'erreur

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.

CodeHTTPQue faire
missing_api_key / invalid_api_key401Envoie une clé valide dans X-API-Key.
revoked_key401Crée une nouvelle clé ; celle-ci a été révoquée.
rate_limit429Attends jusqu'à Retry-After. Ne relance pas immédiatement.
unknown_symbol404Vérifie /v1/markets.
symbol_required, margin_usd_min_1, margin_usd_max_100000, id_required400Corrige le corps de la requête.
sl_wrong_side / tp_wrong_side400La réponse contient live - place le niveau du bon côté de ce prix.
stop_wrong_side400Une 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_invalid400trail_pct est un pourcentage entre 0.05 et 50 ; une valeur hors plage est refusée, jamais plafonnée en silence.
nothing_to_modify400/modify_order nécessite au moins un champ.
plan_required402Les webhooks nécessitent un plan payant. Tout le reste de cette page est sur Free. Le corps contient plan_needed.
premium_required402Ancien code de plan_required, toujours envoyé pour qu'un bot 2.3 le reconnaisse.
too_many_webhooks409Supprime-en un d'abord - 15 hooks avec API Premium.
bad_url / bad_event400Les URL de webhook sont en https sur un hôte public ; les noms d'événements sont listés dans GET /webhooks.
too_many_open409Tu as atteint le plafond de positions ouvertes de ton plan. Clôture quelque chose.
already_closed400Sans danger lors d'une nouvelle tentative - la position est déjà réglée.
no_price400Pas de prix en direct à cet instant ; la position reste ouverte. Réessaie.
unavailable503Transitoire. 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.

API de données de liquidation gratuite DONNÉES EN DIRECT

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.

GET/api/v1/feedLes liquidations les plus récentes sur TOUS les symboles suivis - {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.
GET/api/v1/liquidations/live?symbol=BTC&limit=400Liquidations récentes brutes pour un symbole (BTC, ETH, SOL, XRP, DOGE, BNB, ADA, LINK, AVAX, LTC). side vaut long_liquidated ou short_liquidated, notional est la taille en USD.
GET/api/v1/liquidations/recent?symbol=BTC&minutes=1440Histogramme par tranches de temps ($ long vs short par tranche) pour les graphiques - la source exacte des stats de notre heatmap. minutes : jusqu'à 43200 (30 jours).
GET/api/v1/clusters?symbol=BTCClusters de liquidations modélisés : les niveaux de prix où la liquidité de liquidation est estimée se trouver en ce moment - {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.

Backtest, paper, réel - dans cet ordre

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.

BacktestingPaper trading (cette API)Trading réel
PrixBougies historiquesVrais prix en direct, en temps réelVrais prix en direct
RisqueAucunAucun - des dollars simulésArgent réel en jeu
Détecte les bugs de logiqueRarement - les données rejouées les masquentOui - même chemin de code qu'en directOui, mais chaque bug coûte de l'argent
Contrôle du surapprentissageNon - tu as réglé ta stratégie sur ces donnéesOui - des données futures jamais vuesOui
CoûtGratuitGratuit - frais & funding simulésFrais + pertes + funding
Idéal pourFiltrer les idées rapidementProuver le bot avant d'y mettre de l'argentUne 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.

Étape trois : où faire tourner le bot pour de vrai

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 :

HLHyperliquidon-chain · pensé pour l'API

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.

4%de réduction sur les frais
avec le code MARGINPAD
Rejoindre Hyperliquid →
BBybitcentralisé · carnets les plus profonds

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 →
Liens d'affiliation - MarginPad peut toucher une commission si tu ouvres un compte, sans frais pour toi ; la remise Hyperliquid est leur remise de parrainage. L'API paper reste gratuite dans tous les cas, et rien ici ne nécessite de compte d'exchange. Hyperliquid n'est pas accessible aux personnes américaines selon ses conditions.

FAQ

Existe-t-il une API gratuite de données de liquidation / heatmap ?

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.

L'API de bot de trading est-elle vraiment gratuite ?

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.

Quels langages de programmation puis-je utiliser ?

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.

Quels coins mon bot peut-il trader ?

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.

Ai-je besoin d'un compte d'exchange ou d'un dépôt ?

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.

MarginPad Premium inclut-il l'API ?

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.

Guides et tutoriels