API MarginPad - data kripto gratis, Bot API paper trading, MCP | MarginPad
MARGINPAD
Beranda / API

API MarginPad

Semua yang diketahui situs ini, dalam bentuk JSON: harga dan candle live, screener bernilai skor, funding, open interest, long/short, likuidasi yang diukur dari dua belas exchange, kalender ekonomi - tanpa key. Ditambah Bot API paper trading lengkap untuk forward-test bot trading di harga nyata tanpa uang sungguhan, server MCP remote agar asisten AI bisa memakai semuanya secara native, spesifikasi OpenAPI 3.1 dan client Python serta JavaScript satu file.

Data pasar tanpa key · 60 req/menitKey gratis · 120 req/menitPremium · 600 req/menitCORS di semua endpointOpenAPI 3.1MCP · 23 toolBot API 2.4.0

Data pasar - /api/v1/*, tanpa key

Setiap respons berbentuk envelope { ok, data, ts } ({ ok:false, error:{ code, message } } saat gagal) dengan CORS aktif, jadi halaman browser bisa memanggilnya langsung. 60 request per menit per IP tanpa key. Kirim X-API-Key gratis (dari /trading-api/) di panggilan yang sama dan kuotanya dihitung dari key-mu - 120 per menit, 600 di Premium. Manual lengkap dengan contoh: /free-crypto-api/.

EndpointYang kamu dapat
GET/api/v1/price?symbol=BTCHarga live satu koin, diagregasi dari Binance / Bybit / OKX / Gate.
GET/api/v1/pricesSnapshot batch koin teratas dalam satu panggilan.
GET/api/v1/klines?symbol=BTC&interval=60Candle OHLC: 1, 5, 15, 60, 240, 1440 menit; hingga 1000 per panggilan, &end= untuk mundur ke halaman sebelumnya.
GET/api/v1/symbolsSekitar 500 simbol perp USDT yang likuid, diurutkan volume.
GET/api/v1/screenerScreener futures bernilai skor: skor 0-100, verdict, RSI, MACD, tren, setup ATR.
GET/api/v1/fundingFunding rate di sekitar 160 pair, diukur dari endpoint publik exchange.
GET/api/v1/open-interestOpen interest (USD) di sekitar 160 pair.
GET/api/v1/long-shortRasio akun long/short untuk koin besar (Binance + OKX + Bybit).
GET/api/v1/liquidationsTotal likuidasi 24 jam per koin, long vs short, dari collector dua belas exchange milik kami sendiri.
GET/api/v1/venuesLikuidasi per exchange: total 24 jam, porsi, rasio long/short.
GET/api/v1/feedEvent likuidasi terbaru di semua simbol (beberapa detik di belakang exchange).
GET/api/v1/liquidations/live?symbol=BTCData mentah likuidasi terbaru untuk satu simbol.
GET/api/v1/liquidations/recent?symbol=BTC&minutes=1440Histogram long/short per rentang waktu, hingga 30 hari.
GET/api/v1/clusters?symbol=BTCModel klaster likuidasi: level harga tempat aksi jual paksa menumpuk saat ini.
GET/api/v1/calendarFOMC, CPI, NFP, kedaluwarsa opsi dan momen penting kripto dengan timestamp UTC.
GET/api/v1/fear-greedIndeks Fear & Greed, nilai dan klasifikasinya.
GET/api/v1/coinsSekitar 250 koin teratas: harga, kapitalisasi pasar, perubahan 1h/24h/7d, sparkline.
GET/api/v1/globalTotal kapitalisasi pasar, volume, dominasi BTC.
GET/api/v1/trendingKoin yang sedang trending.
GET/api/v1/defiTVL DeFi: chain, protokol, stablecoin.
GET/api/latam/ar · /api/latam/brKurs regional: USDT dalam peso Argentina di 35 exchange; Bitcoin dan USDT dalam real Brasil beserta premi di atas dolar komersial.
GET/api/v1/calc/liquidation · position-size · pnl · risk-reward · take-profitLima kalkulator di bawah, dalam envelope yang sama.
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 paper trading - /api/bot/v1/* dan /api/bot/v2/*

Arahkan bot trading ke harga live sungguhan dan selesaikan setiap trade dalam dolar simulasi: isolated margin, leverage hingga 1000×, likuidasi dikonfirmasi di candle 1 menit, biaya taker dan funding ditagih seperti di exchange. Masuk dengan email dan buat key di /trading-api/; posisi tersimpan di akunmu dan dihitung untuk papan musim. Bentuk respons v1 dibekukan; v2 adalah API yang sama dalam envelope { ok, data, ts }. Auth: X-API-Key.

EndpointFungsinya
GET/api/bot/v1/price · /klines · /time · /marketsHarga eksekusi, candle, jam server (dengan drift_ms) dan semua simbol yang bisa ditradingkan beserta batas leverage dan biayanya - tiga yang pertama tidak butuh key.
POST/api/bot/v1/openBuka posisi market di harga live dengan opsi sl, tp, trail_pct 2.3, client_order_id (retry idempoten) dan dry_run 2.3 (hitung harganya, tidak menulis apa pun).
POST/api/bot/v1/open type: limit | stopOrder tertunda yang tereksekusi DI levelmu dari candle 1m saat bot sedang offline: limit di bawah pasar atau stop entry di atasnya 2.3.
GET/api/bot/v1/ordersOrder tertunda (dengan type) plus 20 terakhir yang tereksekusi, kedaluwarsa atau dibatalkan.
POST/api/bot/v1/modify_orderUbah order tertunda yang sudah terpasang, tanpa membuat ulang: harga, sl, tp, margin, leverage dan trailing stop 2.3.
POST/api/bot/v1/cancel_orderBatalkan order tertunda (order yang sudah tereksekusi menjawab 409, jadi retry tidak pernah bisa membatalkan eksekusi).
POST/api/bot/v1/close · /close_allTutup satu posisi, sebagian dengan pct, atau semuanya; P&L diselesaikan bersih setelah biaya pulang-pergi dan funding.
POST/api/bot/v1/sltpGeser stop-loss, take-profit atau trailing stop di posisi terbuka tanpa menutupnya.
GET/api/bot/v1/positions?status=openPosisi dengan mark price live dan P&L; ETag / 304 saat tidak ada yang berubah; ?since=.
GET/api/bot/v1/trades · /account · /balance · /usageLedger trade tertutup per halaman, statistik akun seumur hidup, saldo dan ekuitas, paketmu beserta batas dan haknya.
GET/api/bot/v1/feesKenakan biaya eksekusi paper-mu sesuai jadwal biaya taker venue sungguhan dikurangi diskon referral kami (Bybit, Binance, OKX, Bitget, MEXC, Gate, KuCoin, Kraken, Hyperliquid); POST mengatur default akun, fee_venue saat open akan menimpanya 2.4.
GET/api/bot/v1/report?days=30Laporan trading 30 harimu: total dan skor skill gratis; rincian per koin / leverage / arah / jam / hari dan temuan tertulis di Premium 2.3.
WSwss://marginpad.io/api/bot/v2/stream?api_key=…Event posisi dibuka / diperbarui / ditutup dan mark price dikirim setiap ~2 detik. Gratis di semua paket.
GET/api/bot/v1/webhooks PremiumEvent trading yang di-POST ke URL-mu sendiri, ditandatangani HMAC-SHA256 dan dikirim ulang, baik bot sedang terhubung maupun tidak 2.3.
POST/api/bot/v1/ai PremiumBacaan AI dari panel chart lewat API: jawaban, rencana yang sudah diurai dan brief yang jadi dasar penalarannya, 50 per hari 2.3.
PaketGratisPremium ($11.99/bln)
Request / menit per key (trading dan data pasar)120600
API key · posisi terbuka · order tertunda3 · 50 · 2010 · 200 · 20
Data pasar, WebSocket, MCP, order limit & stop, trailing stop, modifikasi, dry run, jadwal biaya venuetermasuktermasuk
Webhook · bacaan pasar AI · rincian laporan-3 hook · 50/hari · laporan lengkap

Dokumentasi lengkap, quickstart, kode error dan catatan keandalan (idempotensi, ETag, WebSocket) ada di /trading-api/. Setiap perubahan dicatat di /api/changelog (JSON di /api/changelog?format=json); versi saat ini 2.4.0.

Saat bot sudah terbukti, ia butuh key exchange sungguhan

Semua di atas diselesaikan dalam dolar simulasi. Begitu strategi sudah bertahan berminggu-minggu forward testing, kode yang sama butuh API live untuk memasang order sungguhan. Dua venue yang kami sarankan untuk pembuat bot:

HLHyperliquidon-chain · API-first

Perp di chain mereka sendiri dengan API REST dan WebSocket publik, sub-akun yang masing-masing punya API wallet sendiri, funding per jam dan order book yang bisa diaudit siapa pun on-chain.

4%diskon biaya trading
dengan kode MARGINPAD
Gabung Hyperliquid →
BBybittersentralisasi · order book terdalam

Bentuk REST dan WebSocket yang mirip API ini, key terpisah per sub-akun, dan salah satu feed sumber harga kami sendiri. Pilihan default kalau kamu mau order book tersentralisasi dengan on-ramp fiat.

Buka akun Bybit →
Link referral - MarginPad bisa mendapat komisi jika kamu membuka akun, tanpa biaya untukmu; diskon Hyperliquid adalah diskon referral dari mereka. Semua API di halaman ini tetap gratis apa pun pilihanmu. Hyperliquid tidak tersedia untuk warga AS sesuai ketentuannya.

MCP - pakai dari Claude, ChatGPT atau Cursor

Tambahkan https://marginpad.io/mcp sebagai server MCP remote (Streamable HTTP). Tool data pasar tidak butuh key; pasang header X-API-Key untuk tool paper trading. 23 tool: 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.

Client - satu file, tanpa dependensi

marginpad.py (Python 3.8+, hanya urllib; websockets opsional untuk stream) dan marginpad.js (Node 18+ atau browser). Keduanya mencakup data pasar, semua panggilan paper trading, polling ETag, back-off 429, stream WebSocket dan verifikasi signature webhook.

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"])

Kalkulator - /api/*, JSON biasa

API JSON publik dan gratis untuk perhitungan futures kripto yang paling umum. Tanpa API key, tanpa daftar, CORS aktif - panggil dari mana saja.

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)

Harga likuidasi

GET /api/liquidation?entry=60000&leverage=10&side=long&mmr=0.5
entrywajib - harga entry
leveragewajib - kelipatan leverage (>0)
sideopsional - long (default) atau short
mmropsional - rasio maintenance margin %, default 0.5
{
  "side": "long",
  "liquidationPrice": 54300,
  "distancePct": -9.5
}

Ukuran posisi (berdasarkan risiko)

GET /api/position-size?balance=5000&risk=1&entry=60000&stop=58800&leverage=10
balancewajib - saldo akun
riskwajib - risiko per trade %
entrywajib - harga entry
stopwajib - harga stop-loss
leverageopsional - untuk margin yang dibutuhkan
{ "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 }

Risk / reward

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

Target take-profit

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

Catatan

Perhitungan memakai estimasi isolated margin dan untuk edukasi, bukan nasihat keuangan. Angka tidak termasuk biaya exchange dan funding. API disediakan gratis dan apa adanya. Kalau kamu membangun sesuatu dengannya, link balik ke marginpad.io sangat kami hargai. Data pasar gratis untuk penggunaan publik, atribusi dihargai; Bot API adalah simulator dan tidak pernah menyentuh dana sungguhan. Hanya untuk edukasi, bukan nasihat keuangan.

Bangun sesuatu dengannya

Ambil API key gratis dalam semenit, atau masukkan URL MCP ke asistenmu dan tanya apa yang sedang terlihat bullish.

Ambil API key gratis →