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.
marginpad.py / marginpad.js tanpa dependensi.Spesifikasi →
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/.
| Endpoint | Yang kamu dapat | |
|---|---|---|
| GET | /api/v1/price?symbol=BTC | Harga live satu koin, diagregasi dari Binance / Bybit / OKX / Gate. |
| GET | /api/v1/prices | Snapshot batch koin teratas dalam satu panggilan. |
| GET | /api/v1/klines?symbol=BTC&interval=60 | Candle OHLC: 1, 5, 15, 60, 240, 1440 menit; hingga 1000 per panggilan, &end= untuk mundur ke halaman sebelumnya. |
| GET | /api/v1/symbols | Sekitar 500 simbol perp USDT yang likuid, diurutkan volume. |
| GET | /api/v1/screener | Screener futures bernilai skor: skor 0-100, verdict, RSI, MACD, tren, setup ATR. |
| GET | /api/v1/funding | Funding rate di sekitar 160 pair, diukur dari endpoint publik exchange. |
| GET | /api/v1/open-interest | Open interest (USD) di sekitar 160 pair. |
| GET | /api/v1/long-short | Rasio akun long/short untuk koin besar (Binance + OKX + Bybit). |
| GET | /api/v1/liquidations | Total likuidasi 24 jam per koin, long vs short, dari collector dua belas exchange milik kami sendiri. |
| GET | /api/v1/venues | Likuidasi per exchange: total 24 jam, porsi, rasio long/short. |
| GET | /api/v1/feed | Event likuidasi terbaru di semua simbol (beberapa detik di belakang exchange). |
| GET | /api/v1/liquidations/live?symbol=BTC | Data mentah likuidasi terbaru untuk satu simbol. |
| GET | /api/v1/liquidations/recent?symbol=BTC&minutes=1440 | Histogram long/short per rentang waktu, hingga 30 hari. |
| GET | /api/v1/clusters?symbol=BTC | Model klaster likuidasi: level harga tempat aksi jual paksa menumpuk saat ini. |
| GET | /api/v1/calendar | FOMC, CPI, NFP, kedaluwarsa opsi dan momen penting kripto dengan timestamp UTC. |
| GET | /api/v1/fear-greed | Indeks Fear & Greed, nilai dan klasifikasinya. |
| GET | /api/v1/coins | Sekitar 250 koin teratas: harga, kapitalisasi pasar, perubahan 1h/24h/7d, sparkline. |
| GET | /api/v1/global | Total kapitalisasi pasar, volume, dominasi BTC. |
| GET | /api/v1/trending | Koin yang sedang trending. |
| GET | /api/v1/defi | TVL DeFi: chain, protokol, stablecoin. |
| GET | /api/latam/ar · /api/latam/br | Kurs 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-profit | Lima 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.
| Endpoint | Fungsinya | |
|---|---|---|
| GET | /api/bot/v1/price · /klines · /time · /markets | Harga 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/open | Buka 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 | stop | Order 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/orders | Order tertunda (dengan type) plus 20 terakhir yang tereksekusi, kedaluwarsa atau dibatalkan. |
| POST | /api/bot/v1/modify_order | Ubah order tertunda yang sudah terpasang, tanpa membuat ulang: harga, sl, tp, margin, leverage dan trailing stop 2.3. |
| POST | /api/bot/v1/cancel_order | Batalkan order tertunda (order yang sudah tereksekusi menjawab 409, jadi retry tidak pernah bisa membatalkan eksekusi). |
| POST | /api/bot/v1/close · /close_all | Tutup satu posisi, sebagian dengan pct, atau semuanya; P&L diselesaikan bersih setelah biaya pulang-pergi dan funding. |
| POST | /api/bot/v1/sltp | Geser stop-loss, take-profit atau trailing stop di posisi terbuka tanpa menutupnya. |
| GET | /api/bot/v1/positions?status=open | Posisi dengan mark price live dan P&L; ETag / 304 saat tidak ada yang berubah; ?since=. |
| GET | /api/bot/v1/trades · /account · /balance · /usage | Ledger trade tertutup per halaman, statistik akun seumur hidup, saldo dan ekuitas, paketmu beserta batas dan haknya. |
| GET | /api/bot/v1/fees | Kenakan 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=30 | Laporan trading 30 harimu: total dan skor skill gratis; rincian per koin / leverage / arah / jam / hari dan temuan tertulis di Premium 2.3. |
| WS | wss://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 Premium | Event 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 Premium | Bacaan AI dari panel chart lewat API: jawaban, rencana yang sudah diurai dan brief yang jadi dasar penalarannya, 50 per hari 2.3. |
| Paket | Gratis | Premium ($11.99/bln) |
|---|---|---|
| Request / menit per key (trading dan data pasar) | 120 | 600 |
| API key · posisi terbuka · order tertunda | 3 · 50 · 20 | 10 · 200 · 20 |
| Data pasar, WebSocket, MCP, order limit & stop, trailing stop, modifikasi, dry run, jadwal biaya venue | termasuk | termasuk |
| 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.
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:
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.
dengan kode MARGINPAD
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 →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
| entry | wajib - harga entry |
| leverage | wajib - kelipatan leverage (>0) |
| side | opsional - long (default) atau short |
| mmr | opsional - rasio maintenance margin %, default 0.5 |
{
"side": "long",
"liquidationPrice": 54300,
"distancePct": -9.5
}
Ukuran posisi (berdasarkan risiko)
| balance | wajib - saldo akun |
| risk | wajib - risiko per trade % |
| entry | wajib - harga entry |
| stop | wajib - harga stop-loss |
| leverage | opsional - untuk margin yang dibutuhkan |
{ "positionSize": 0.041667, "notional": 2500, "riskAmount": 50, "marginRequired": 250 }
PnL / ROI / ROE
{ "pnl": 3000, "roiPct": 10, "roePct": 100 }
Risk / reward
{ "riskRewardRatio": 3, "riskPerUnit": 2000, "rewardPerUnit": 6000, "breakevenWinRatePct": 25 }
Target take-profit
{ "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 →