API MarginPad - données crypto gratuites, Bot API de paper trading, MCP | MarginPad
MARGINPAD
Accueil / API

API MarginPad

Tout ce que le site sait, en JSON : prix et bougies en direct, un screener noté, funding, open interest, long/short, liquidations mesurées sur douze exchanges, un calendrier économique - sans clé. Plus un Bot API de paper trading complet pour tester un bot de trading en conditions réelles sur de vrais prix sans argent réel, un serveur MCP distant pour qu'un assistant IA puisse tout utiliser nativement, une spécification OpenAPI 3.1 et des clients Python et JavaScript en un seul fichier.

Données de marché sans clé · 60 req/minClé gratuite · 120 req/minPremium · 600 req/minCORS partoutOpenAPI 3.1MCP · 23 outilsBot API 2.4.0

Données de marché - /api/v1/*, sans clé

Chaque réponse est l'enveloppe { ok, data, ts } ({ ok:false, error:{ code, message } } en cas d'échec) avec CORS activé, pour qu'une page web puisse l'appeler directement. 60 requêtes par minute et par IP sans clé. Envoie une X-API-Key gratuite (obtenue sur /trading-api/) sur les mêmes appels et ils sont décomptés sur ta clé à la place - 120 par minute, 600 avec Premium. Manuel complet avec exemples : /free-crypto-api/.

EndpointCe que tu obtiens
GET/api/v1/price?symbol=BTCPrix en direct d'un coin, agrégé sur Binance / Bybit / OKX / Gate.
GET/api/v1/pricesInstantané groupé des principaux coins en un seul appel.
GET/api/v1/klines?symbol=BTC&interval=60Bougies OHLC : 1, 5, 15, 60, 240, 1440 minutes ; jusqu'à 1000 par appel, &end= pour remonter dans l'historique.
GET/api/v1/symbols~500 symboles perp USDT liquides, classés par volume.
GET/api/v1/screenerScreener de futures noté : score 0-100, verdict, RSI, MACD, tendance, setup ATR.
GET/api/v1/fundingTaux de funding sur ~160 paires, mesurés depuis les endpoints publics des exchanges.
GET/api/v1/open-interestOpen interest (USD) sur ~160 paires.
GET/api/v1/long-shortRatio de comptes long/short sur les majeurs (Binance + OKX + Bybit).
GET/api/v1/liquidationsTotaux de liquidations 24h par coin, longs contre shorts, issus de notre propre collecteur sur douze exchanges.
GET/api/v1/venuesLiquidations par exchange : total 24h, part, répartition long/short.
GET/api/v1/feedLes événements de liquidation les plus récents sur tous les symboles (quelques secondes de retard sur les exchanges).
GET/api/v1/liquidations/live?symbol=BTCÉvénements de liquidation récents bruts pour un symbole.
GET/api/v1/liquidations/recent?symbol=BTC&minutes=1440Histogramme long/short par tranches de temps, jusqu'à 30 jours.
GET/api/v1/clusters?symbol=BTCClusters de liquidation modélisés : les niveaux de prix où se trouvent les ventes forcées en ce moment.
GET/api/v1/calendarFOMC, CPI, NFP, expirations d'options et jalons crypto, avec horodatage UTC.
GET/api/v1/fear-greedIndice Fear & Greed, valeur et classification.
GET/api/v1/coinsTop ~250 coins : prix, capitalisation, variation 1h/24h/7j, sparkline.
GET/api/v1/globalCapitalisation totale, volume, dominance BTC.
GET/api/v1/trendingCoins tendance.
GET/api/v1/defiTVL DeFi : blockchains, protocoles, stablecoins.
GET/api/latam/ar · /api/latam/brCotations régionales : l'USDT en pesos argentins sur 35 exchanges ; le Bitcoin et l'USDT en réais avec la prime sur le dollar commercial.
GET/api/v1/calc/liquidation · position-size · pnl · risk-reward · take-profitLes cinq calculateurs ci-dessous, dans la même enveloppe.
curl "https://marginpad.io/api/v1/price?symbol=BTC"
curl "https://marginpad.io/api/v1/screener"
curl -H "X-API-Key: mpb_..." "https://marginpad.io/api/v1/klines?symbol=ETH&interval=15"   # counts against your key, not your IP

Bot API de paper trading - /api/bot/v1/* et /api/bot/v2/*

Branche un bot de trading sur de vrais prix en direct et règle chaque trade en dollars simulés : marge isolée, levier jusqu'à 1000×, liquidations confirmées sur des bougies 1 minute, frais taker et funding facturés comme sur un exchange. Connecte-toi avec un email et génère une clé sur /trading-api/ ; les positions vivent sur ton compte et comptent pour les classements de la saison. Les formats de réponse v1 sont figés ; v2 est la même API dans l'enveloppe { ok, data, ts }. Authentification : X-API-Key.

EndpointCe que ça fait
GET/api/bot/v1/price · /klines · /time · /marketsPrix d'exécution, bougies, horloge serveur (avec drift_ms) et chaque symbole tradable avec son levier maximal et ses frais - les trois premiers ne demandent aucune clé.
POST/api/bot/v1/openOuverture au marché au prix en direct, avec en option sl, tp, trail_pct 2.3, client_order_id (relances idempotentes) et dry_run 2.3 (calcule le prix sans rien enregistrer).
POST/api/bot/v1/open type: limit | stopDes ordres en attente exécutés À ton niveau à partir des bougies 1m pendant que le bot est hors ligne : un ordre limite sous le marché ou une entrée stop au-dessus 2.3.
GET/api/bot/v1/ordersOrdres en attente (avec type) plus les 20 derniers exécutés, expirés ou annulés.
POST/api/bot/v1/modify_orderModifie un ordre en attente sur place : prix, sl, tp, marge, levier, trailing stop 2.3.
POST/api/bot/v1/cancel_orderAnnule un ordre en attente (un ordre exécuté répond 409, donc une relance ne peut jamais annuler une exécution).
POST/api/bot/v1/close · /close_allClôture une position, partiellement avec pct, ou tout d'un coup ; le P&L se règle net des frais aller-retour et du funding.
POST/api/bot/v1/sltpDéplace le stop-loss, le take-profit ou le trailing stop d'une position ouverte sans la clôturer.
GET/api/bot/v1/positions?status=openPositions avec mark price en direct et P&L ; ETag / 304 quand rien n'a changé ; ?since=.
GET/api/bot/v1/trades · /account · /balance · /usageHistorique paginé des trades clôturés, statistiques du compte depuis l'ouverture, solde et equity, ton plan avec ses limites et ses droits.
GET/api/bot/v1/feesFacture tes exécutions fictives selon la grille taker d'une vraie plateforme, moins notre réduction de parrainage (Bybit, Binance, OKX, Bitget, MEXC, Gate, KuCoin, Kraken, Hyperliquid) ; un POST définit la valeur par défaut du compte, fee_venue à l'ouverture la remplace 2.4.
GET/api/bot/v1/report?days=30Ton rapport de trading sur 30 jours : totaux et score de compétence gratuits ; détail par coin / levier / sens / heure / jour et constats rédigés avec Premium 2.3.
WSwss://marginpad.io/api/bot/v2/stream?api_key=…Événements de position ouverte / mise à jour / clôturée et mark prices poussés toutes les ~2 s. Gratuit sur tous les plans.
GET/api/bot/v1/webhooks PremiumLes événements de trading envoyés en POST vers ta propre URL, signés HMAC-SHA256 et relancés, que le bot soit connecté ou non 2.3.
POST/api/bot/v1/ai PremiumLa lecture IA du panneau de graphique via l'API : une réponse, un plan structuré et le brief sur lequel elle a raisonné, 50 par jour 2.3.
PlanGratuitPremium ($11.99/mois)
Requêtes / minute par clé (trading et données de marché)120600
Clés API · positions ouvertes · ordres en attente3 · 50 · 2010 · 200 · 20
Données de marché, WebSocket, MCP, ordres limite & stop, trailing stops, modification, dry run, grilles de frais par plateformeinclusinclus
Webhooks · lecture de marché IA · détails du rapport-3 hooks · 50/jour · rapport complet

La documentation complète, le quickstart, les codes d'erreur et les notes de fiabilité (idempotence, ETags, le WebSocket) sont sur /trading-api/. Chaque changement est consigné sur /api/changelog (JSON sur /api/changelog?format=json) ; la version actuelle est la 2.4.0.

Quand le bot a fait ses preuves, il lui faut une vraie clé d'exchange

Tout ce qui précède se règle en dollars simulés. Une fois qu'une stratégie a survécu à des semaines de tests en conditions réelles, le même code a besoin d'une API live pour passer de vrais ordres. Deux plateformes que nous recommandons aux créateurs de bots :

HLHyperliquidon-chain · pensé pour l'API

Des perps sur leur propre blockchain avec une API REST et WebSocket publique, des sous-comptes qui ont chacun leur propre wallet API, un funding horaire et un carnet d'ordres que n'importe qui peut auditer on-chain.

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 cette API, une clé distincte par sous-compte, et l'un des flux dont proviennent nos propres prix. Le choix par défaut quand tu veux un carnet centralisé avec des rampes d'accès fiat.

Ouvrir un compte Bybit →
Liens de parrainage - MarginPad peut toucher une commission si tu ouvres un compte, sans aucun coût pour toi ; la réduction Hyperliquid est leur réduction de parrainage. Toutes les API de cette page restent gratuites dans tous les cas. Hyperliquid n'est pas accessible aux personnes américaines selon ses conditions.

MCP - utilise-le depuis Claude, ChatGPT ou Cursor

Ajoute https://marginpad.io/mcp comme serveur MCP distant (Streamable HTTP). Les outils de données de marché ne demandent aucune clé ; ajoute l'en-tête X-API-Key pour les outils de paper trading. 23 outils : get_price, get_klines, get_markets, get_screener, get_funding, get_open_interest, get_liquidations, get_fear_greed, get_economic_calendar, calc_liquidation, calc_position_size, paper_balance, paper_positions, paper_trades, paper_open, paper_close, paper_sltp, paper_modify_order, paper_fees, paper_report, paper_limit_order, paper_orders, paper_cancel_order.

Clients - un fichier, zéro dépendance

marginpad.py (Python 3.8+, urllib uniquement ; websockets en option pour le flux) et marginpad.js (Node 18+ ou un navigateur). Les deux couvrent les données de marché, chaque appel de paper trading, le polling par ETag, le back-off sur les 429, le flux WebSocket et la vérification de signature des webhooks.

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

Calculateurs - /api/*, JSON simple

Une API JSON publique et gratuite pour les calculs de futures crypto les plus courants. Sans clé API, sans inscription, CORS activé - appelle-la de n'importe où.

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

Prix de liquidation

GET /api/liquidation?entry=60000&leverage=10&side=long&mmr=0.5
entryrequis - prix d'entrée
leveragerequis - multiple de levier (>0)
sideoptionnel - long (par défaut) ou short
mmroptionnel - taux de marge de maintenance en %, 0.5 par défaut
{
  "side": "long",
  "liquidationPrice": 54300,
  "distancePct": -9.5
}

Taille de position (selon le risque)

GET /api/position-size?balance=5000&risk=1&entry=60000&stop=58800&leverage=10
balancerequis - solde du compte
riskrequis - risque par trade en %
entryrequis - prix d'entrée
stoprequis - prix du stop-loss
leverageoptionnel - pour la marge requise
{ "positionSize": 0.041667, "notional": 2500, "riskAmount": 50, "marginRequired": 250 }

PnL / ROI / ROE

GET /api/pnl?entry=60000&exit=66000&size=0.5&leverage=10&side=long
{ "pnl": 3000, "roiPct": 10, "roePct": 100 }

Risque / rendement

GET /api/risk-reward?entry=60000&stop=58000&tp=66000
{ "riskRewardRatio": 3, "riskPerUnit": 2000, "rewardPerUnit": 6000, "breakevenWinRatePct": 25 }

Objectif du take-profit

GET /api/take-profit?entry=60000&leverage=10&roe=75&side=long
{ "targetExitPrice": 64500, "priceMovePct": 7.5 }

Remarques

Les calculs utilisent l'estimation en marge isolée et sont fournis à titre éducatif, pas comme un conseil financier. Les chiffres excluent les frais d'exchange et le funding. L'API est fournie gratuitement et en l'état. Si tu construis quelque chose avec, un lien vers marginpad.io est apprécié. Les données de marché sont libres pour un usage public, une attribution est appréciée ; le Bot API est un simulateur et ne touche jamais à de vrais fonds. À but éducatif uniquement, ceci n'est pas un conseil financier.

Construis quelque chose avec

Obtiens une clé API gratuite en une minute, ou colle l'URL MCP dans ton assistant et demande-lui ce qui semble haussier en ce moment.

Obtenir une clé API gratuite →