API paper trading futures dengan harga live sungguhan. Bot-mu membuka posisi ber-leverage, memasang order limit dan stop, menggeser trailing stop, dan bisa kena likuidasi - semuanya diselesaikan di server kami, dalam dolar simulasi. Kode yang sama dengan yang akan kamu jalankan sungguhan, tanpa konsekuensinya.
Tanpa kartu, tanpa KYC, tanpa deposit. Setiap kondisi eksekusi kamu yang atur - ukuran book, slippage, latensi, eksekusi sebagian, penolakan, biaya. Gratis selamanya di 120 request per menit - API Premium $11.99 kalau kamu butuh arsip pasar kami, webhook, dan banyak book. Data pasar tetap tanpa key di semua plan.
# no key needed - run this right now curl "https://marginpad.io/api/bot/v1/price?symbol=BTC" { "symbol": "BTC", "price": …, "ts": … }
curl -X POST ".../v1/open" -H "X-API-Key: mpb_…" \ -d '{"symbol":"BTC","side":"long","margin_usd":100, "leverage":10,"trail_pct":1.5}' { "ok": true, "position": { "id": "bot_9f21…", "entry": …, "liq_price": …, "trail_pct": 1.5, "fee_round_trip_usd": 1.10 } }
Masuk dengan email - tanpa password, tanpa KYC. Posisi bot-mu tersimpan di akunmu, dan satu akun bisa punya beberapa key supaya bot backtest dan bot live tidak pernah berbagi jatah rate.
| Nama | Book | Key | Panggilan | Terakhir dipakai |
|---|
Key-mu, pemakaiannya, dan book yang ditradingkan tiap key muncul di sini setelah kamu masuk. Key bersifat rahasia - siapa pun yang memegangnya bisa trading di akun paper-mu.
Gratis tanpa batas waktu dan tanpa kartu: seluruh engine trading, biaya exchange asli, limit dan stop entry, trailing stop, replay, simulasi yang bisa dikonfigurasi, stream WebSocket, dan semua data pasar live. API Premium menambahkan apa yang dibutuhkan build serius - arsip pasar kami lewat API (9 dataset yang tidak dipublikasikan siapa pun, setiap likuidasi sejak Juli 2026), ladder order book mentah, webhook, banyak book, dan riwayat trade 90 hari. Ini langganan terpisah dari Premium situs.
Semua yang kamu butuhkan untuk menguji bot: seluruh engine, stream, replay, dan data pasar live. Tanpa kartu, tanpa trial, tanpa hitung mundur.
Untuk membangun sesuatu yang serius: backtest di riwayat terukur kami, bereaksi lewat webhook, jalankan beberapa strategi berdampingan.
/v1/history - 9 dataset, satu CSV terverifikasi per hari UTC| Apa yang berubah sesuai paket | Free | API Premium · $11.99 |
|---|---|---|
Arsip pasar /v1/historyliquidations, agg5m, oi, funding_oi, whale_fills, whale_pos, catalysts, longshort, mpad | katalog | setiap hari, setiap dataset |
| Ladder order book mentah per exchange | hanya book gabungan | ya |
| Book - jurnal, saldo, dan report terpisah untuk tiap strategi | 1 | 20 |
| Webhook - bertanda tangan, dengan retry, dikirim saat kamu sedang offline | tidak ada | 15 |
| Riwayat trade disimpan yang masih bisa dilihat /v1/trades, laporan, dan kurva ekuitas | 30 hari | 90 hari |
Laporan trading /v1/report | total, skill score, biaya | + rincian & temuan |
| API key · posisi terbuka | 3 · 50 | 30 · 500 |
Request per menit, per key (engine dan /api/v1/* dengan key)60 / menit per IP tanpa key, di semua plan | 120 | 2000 |
Di setiap paket, termasuk Free: seluruh mesin trading - market, limit, dan stop order, trailing stop, penutupan parsial, dry run, dan replay - stream WebSocket, server MCP, jadwal biaya 9 venue sungguhan, margin $1 sampai $100,000 per trade dengan leverage hingga 1000×, dan semua endpoint data pasar tanpa key dengan kecepatan penuh. Paket berbayar menaikkan batas. Paket berbayar tidak membuka produknya.
Premium adalah produk yang berbeda. Langganan MarginPad Premium membuka fitur di website - indikator chart eksklusif, heatmap likuidasi, Ask-AI di chart - dan sejak 15 September 2026 tidak mengubah satu pun batas API. Plan-plan ini juga tidak membuka fitur website tersebut. Beli yang benar-benar kamu pakai.
Paket berlaku per bulan, dibayar dengan kripto atau langsung dari saldo reward MarginPad-mu, dan bulan yang dibeli lebih awal ditambahkan ke bulan yang sedang berjalan, bukan menggantikannya. Batas live-mu selalu ada di GET /api/bot/v1/usage - limits, features, plan_until - jadi bot bisa membacanya, bukan menebak.
Apa yang kamu beli, tertulis jelas. Bagian 9 ketentuan mengatur API secara tersendiri: apa saja isi sebuah paket dan apa yang terjadi saat paket berakhir, bahwa tidak ada yang diperpanjang otomatis dan tidak ada yang perlu dibatalkan, apa yang kami janjikan dan tidak janjikan soal ketersediaan (tidak ada SLA - kami mengatakannya, dan kami sebutkan apa yang kami janjikan sebagai gantinya), pemberitahuan tiga puluh hari sebelum ada perubahan yang merusak kompatibilitas, dan bahwa kamu boleh membangun dan menjual produk komersial di atas API ini tanpa meminta izin kami.
Bot-mu diberi tahu sebelum paket berakhir, bukan sesudahnya. Setiap response ber-key membawa X-MP-Plan, dan dalam empat belas hari terakhir juga membawa X-MP-Plan-Expires dan X-MP-Plan-Days-Left. Catat header itu dan bot yang berjalan tanpa diawasi bisa memperingatkanmu sendiri; hitung mundur yang sama ada di halaman ini dan di /v1/usage. Paket yang habis menurunkan key ke Free - key-nya tidak pernah berhenti menjawab.
Yang pertama sama sekali tidak butuh key - tempel ke terminal sebelum kamu memutuskan apa pun. Setiap path di bawah ada dalam v1 yang dibekukan dan v2 yang ber-envelope; pilih salah satu dan tidak akan berubah di bawahmu.
GET /v1/price dan /v1/klines tanpa key dan mendukung CORS. Sampai 1,000 candle per panggilan, tujuh interval, bisa di-page mundur dengan &end= untuk riwayat sepanjang yang dibutuhkan backtest.
POST /v1/open mengeksekusi di harga live dengan isolated margin dan mengembalikan level likuidasinya. Tambahkan type:"limit" atau "stop" untuk menaruh order tertunda di server, atau dry_run untuk menghitung harga trade tanpa menyimpan apa pun.
Stop, target, trailing stop, dan likuidasi diselesaikan di sisi kami, berdasarkan candle 1 menit, entah bot-mu sedang jalan atau tidak. Buka WebSocket dan hasilnya tiba dalam sekitar dua detik - gratis di semua plan, dan inilah bedanya bot yang bereaksi dengan bot yang menunggu loop berikutnya.
# price (no key)
curl "https://marginpad.io/api/bot/v1/price?symbol=SOL"
# open a 20x long with $100 margin
curl -X POST "https://marginpad.io/api/bot/v1/open" \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"symbol":"SOL","side":"long","margin_usd":100,"leverage":20}'
# check live P&L
curl "https://marginpad.io/api/bot/v1/positions" -H "X-API-Key: YOUR_KEY"
# close half, let the rest run
curl -X POST "https://marginpad.io/api/bot/v1/close" \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"id":"POSITION_ID","pct":50}'
# the whole loop, without a single poll
const { MarginPad } = require("marginpad");
const mp = new MarginPad("YOUR_KEY");
mp.stream(ev => {
if (ev.type === "snapshot") console.log("open now:", ev.data.positions.length);
if (ev.type === "position") {
const p = ev.data.position; // opened | updated | closed
console.log(ev.data.event, p.symbol, p.pnl_usd ?? p.unrealized_pnl_usd);
if (ev.data.event === "closed") decideWhatIsNext(p);
}
});
# or with nothing but a URL - any language with a WebSocket client
wscat -c "wss://marginpad.io/api/bot/v2/stream?api_key=mpb_..."
<- {"type":"welcome","data":{"channels":["positions","prices"],"tick_ms":2000}}
<- {"type":"snapshot","data":{"positions":[...]}}
<- {"type":"position","data":{"event":"closed","position":{...,"pnl_usd":-1.24}}}
Hasil ukur, dan alasan tab ini ada: 76.4% dari semua panggilan ke API ini dalam 40 hari terakhir adalah polling /positions atau /account - 890,921 dan 471,390 panggilan - sementara WebSocket hanya dibuka 15 kali sepanjang umurnya. Stream sengaja gratis di semua plan - kalau dikunci, semua orang akan kembali ke polling, yang biayanya lebih besar bagi kami daripada stream. Kalau memang harus polling, kirim balik ETag: polling yang tidak berubah cukup dijawab 304 dengan body kosong.
# python - the official client, zero dependencies
pip install marginpad
from marginpad import MarginPad
mp = MarginPad("YOUR_KEY")
price = mp.price("BTC")["price"]
if my_signal(price): # your strategy here
r = mp.open("BTC", "long", margin_usd=50, leverage=10,
sl=price * 0.97, trail_pct=1.5, # trailing stop, ratcheted server-side
client_order_id=f"sig-{int(time.time())}") # a retry can never open twice
print("opened", r["position"]["id"], "liq @", r["position"]["liq_price"])
changed = mp.positions(status="open") # None when nothing changed (ETag / 304)
print(mp.report()["skill"])
# node.js - the official client, zero dependencies
npm install marginpad
const { MarginPad } = require("marginpad");
const mp = new MarginPad("YOUR_KEY");
const { price } = await mp.price("ETH");
if (mySignal(price)) { // your strategy here
const { position } = await mp.open({ symbol: "ETH", side: "short", margin_usd: 50, leverage: 10,
trail_pct: 2, client_order_id: "sig-" + Date.now() });
console.log("opened", position.id, "liq @", position.liq_price);
}
mp.stream(ev => { if (ev.type === "position") console.log(ev.data.event, ev.data.position.id); });
# plain HTTP, any language
import requests
API = "https://marginpad.io/api/bot"; H = {"X-API-Key": "YOUR_KEY"}
r = requests.post(f"{API}/v2/open", headers=H, json={"symbol": "BTC", "side": "long",
"margin_usd": 50, "leverage": 10, "dry_run": True}).json() # priced, nothing written
print(r["data"]["position"]["fee_round_trip_usd"], r["data"]["position"]["liq_price"])
Autentikasi dengan X-API-Key di setiap panggilan kecuali /price, /klines dan /time. Client resmi, tanpa dependensi - npm install marginpad atau pip install marginpad, atau satu file masing-masing: marginpad.py · marginpad.js - REST, WebSocket, polling ETag, back-off 429, dan verifikasi tanda tangan webhook sudah terpasang.
Order book testnet tipis, harganya melenceng dari pasar sungguhan, dan bisa di-reset tanpa peringatan. Semua di sini dihargai dari feed multi-exchange live yang juga dipakai chart kami sendiri - hanya dolarnya yang simulasi.
Delapan belas field dan delapan preset: ukuran book dan apakah itu anggaran sungguhan, berapa ongkos menembus order book saat masuk dan keluar, berapa lama order-mu dalam perjalanan, eksekusi parsial, seberapa sering venue menolak, biayamu sendiri, funding, dan letak likuidasi. Freqtrade hanya membiarkanmu mengatur saldo awal, tidak lebih; testnet memberimu apa pun yang ada di order book-nya. Semua field, dengan rentangnya →
Entry limit, stop entry, stop-loss, target, dan trailing stop semuanya dievaluasi di sisi kami terhadap candle 1 menit. Bot-mu boleh offline, restart, atau di-deploy ulang dan eksekusinya tetap mendarat di level-mu, dicap dengan menit saat pasar benar-benar mencapainya.
Kedua sisi membayar biaya taker, ditagih sebagai pulang-pergi saat penutupan, dengan funding yang terakumulasi di tiap mark. Pilih venue dan akun paper ditagih sesuai jadwal biaya yang dipublikasikan exchange itu dikurangi diskon referral kami - jadi strategi scalping gagal di sini dengan alasan yang sama seperti di sana.
Isolated margin, maintenance 0.5%, rugi dibatasi sebesar margin-mu. Trailing stop digeser oleh titik ekstrem tiap candle setelah candle itu dicek terhadap stop yang berlaku - jadi satu bar tidak akan pernah menghentikanmu di level yang dibuatnya sendiri.
Kirim client_order_id dan open yang diulang akan mengembalikan posisi yang dibuat panggilan pertama, ditandai idempotent: true. Menutup posisi juga menerimanya. Satu field ini adalah pembeda antara bot yang bisa kamu tinggal tanpa diawasi dan bot yang harus terus kamu jaga.
WebSocket gratis mengirim event posisi dan mark price setiap ~2 detik; webhook mem-POST bentuk yang sama ke URL-mu sendiri, ditandatangani HMAC dan dengan retry, bahkan saat tidak ada yang tersambung dari pihakmu. ETag membuat polling yang tetap kamu jalankan nyaris gratis.
Setiap book punya jurnal, kurva ekuitas, dan drawdown sendiri. /v1/report mengembalikan win rate dan return per koin, rentang leverage, arah, dan jam, dengan skor skill - dan tidak berkata apa pun di bawah delapan trade alih-alih mengarang pola.
Ada dua puluh empat. Semuanya JSON lewat HTTPS, CORS aktif, satu header. Ganti v1 dengan v2 di path mana pun untuk envelope {ok,data,ts}.
&end=<unix ms> untuk mundur lebih jauh.?dataset=liquidations&day=2026-10-07 mengembalikan hari UTC itu sebagai CSV gzip, lengkap dengan jumlah baris dan sha256 di X-MP-Rows / X-MP-Sha256: setiap likuidasi sejak 24 Juli 2026, agregat 5 menit, open interest per exchange, OI dan funding per jam untuk setiap perp Bybit, trade dan posisi whale Hyperliquid, catalyst, rasio long/short, dan indeks MPAD.asset_class, max_leverage, dan taker_fee_pct per simbol. Filter dengan ?class=crypto|stock|forex|metal|index. Panggil sekali saat startup daripada menemukan batasnya lewat coba-coba.drift_ms kembali. Bot yang mengelompokkan candle berdasarkan jam lokal yang melenceng membangun bar yang tidak dilihat orang lain, dan itu menyiksa untuk di-debug dari luar.bars = get(f"/api/bot/v1/klines?symbol=BTC&interval=1")
while len(all_bars) < wanted:
end_ms = bars[0]["time"] * 1000 # oldest candle in hand
bars = get(f"/api/bot/v1/klines?symbol=BTC&interval=1&end={end_ms}")
if not bars: break
all_bars = bars + all_bars
{"symbol":"BTC","side":"long","margin_usd":100,"leverage":20,"sl":58000,"tp":66000} (sl/tp opsional). Mengembalikan posisinya termasuk liq_price. Tambahkan "dry_run":true untuk mendapat trade yang sudah dihitung harganya - entry, kuantitas, harga likuidasi dan jaraknya, biaya buka, dan total pulang-pergi - tanpa menyimpan apa pun. Pakai dry run untuk menentukan ukuran posisi atau untuk unit-test bot-mu terhadap engine yang asli.trail_pct memasang stop yang mengikuti harga terbaik sejak entry pada jarak persen itu, digeser di server: dari ekstrem candle 1 menit di sapuan tiap menit dan dari harga live di setiap pembacaan /positions, jadi stop terus bergerak saat bot-mu offline dan tidak pernah melonggar. Long yang dibuka di 60,000 dengan trail_pct: 1 mulai dengan stop di 59,400; saat harga menyentuh 63,000, stop-nya di 62,370. Posisi membawa trail_pct dan trail_hwm.{"symbol":"BTC","side":"long","type":"limit","limit_price":58000,"margin_usd":100,"leverage":20}. Tereksekusi di harga kamu, bukan di harga saat engine menyadari harga sudah melewatinya - eksekusinya dicari dari high/low 1m, jadi wick yang sempat balik di antara dua pengecekan tetap dihitung. Bot-mu tidak perlu sedang jalan. Limit long harus di bawah harga market dan limit short di atasnya; kalau tidak, kamu dapat limit_marketable, bukan eksekusi market diam-diam.{"symbol":"BTC","side":"long","type":"stop","limit_price":66000,"margin_usd":100,"leverage":10}. Mesin yang sama dengan limit order - tereksekusi di level-nya dari candle 1m, dengan browser tertutup - tapi sisi yang salah ditolak (stop_wrong_side) supaya stop dan limit tidak pernah tertukar. sl, tp, trail_pct, client_order_id dan dry_run semuanya berlaku.{"id":"bp...","pct":50} - pct opsional (default 100); penutupan parsial memecah posisi persis seperti di situs.{"id":"bot...","sl":63500,"tp":66000,"trail_pct":1.5} - kirim null untuk menghapus satu nilai, hilangkan field-nya untuk mempertahankannya. Level dicek terhadap sisi entry. Sebelum endpoint ini ada, kamu harus menutup dan membuka ulang posisi untuk menggeser stop, yang mengubah entry-mu dan membayar biaya bolak-balik penuh.type: "limit" | "stop", plus 20 terakhir yang tereksekusi, kedaluwarsa, atau dibatalkan - yang tereksekusi membawa position_id yang dibuatnya. Order berlaku sampai dibatalkan, kedaluwarsa setelah 30 hari, dan maksimal 20 per akun.{"order_id":"lo...","limit_price":58500,"sl":57000,"tp":62000,"margin_usd":150,"leverage":10,"trail_pct":1} - kirim hanya yang berubah. Sebelumnya satu-satunya cara adalah batal lalu pasang ulang, yang menghilangkan client_order_id order itu. Arahnya diturunkan ulang dari pasar saat ini dan penanda candle dimulai ulang, jadi level yang digeser tidak pernah bisa tereksekusi di bar yang tercetak sebelum perubahan. Order yang sudah tereksekusi, dibatalkan, atau kedaluwarsa menjawab 409.{"order_id":"lo..."}. Order yang sudah tereksekusi atau dibatalkan menjawab 409, jadi retry tidak pernah bisa membatalkan eksekusi.mark_price dan unrealized_pnl_usd live; likuidasi dan SL/TP yang tertembus diselesaikan otomatis. ?status=open|closed memangkas body hanya ke yang benar-benar dibaca loop-mu; ?since=<unix ms> dan If-None-Match (304 kalau tidak ada yang berubah) juga didukung.balance_usd, equity_usd, free_margin_usd dan return_pct./account kalau hanya itu yang dibutuhkan logika ukuran posisimu./positions dibatasi 100 baris; endpoint ini menelusuri seluruh jendela retensi - ikuti next_before sampai nilainya kembali null. Pakai untuk menghitung statistik strategi dari catatan lengkap, bukan dari ekor yang terpotong.max_drawdown_pct dan titik belum terealisasi live di ujungnya.{"confirm":true}: trade tertutup diarsipkan, order dibatalkan. Ditolak dengan 409 open_positions_exist selama masih ada yang terbuka.usage_30d - jumlah panggilan per hari per endpoint plus refused (yang kena 429), supaya bot bisa melihat seberapa dekat ia berjalan ke batasnya.POST {"venue":"bybit"} mengatur default akun; fee_venue di /open menimpanya untuk satu posisi. Lihat biaya per venue.locked[] menyebut apa yang ditahan). Setiap temuan menyertakan n yang jadi dasarnya dan tidak menyimpulkan apa pun di bawah 8 trade.POST {"act":"add","url":"https://…"} mendaftarkan satu, {"act":"test","id":…} mengirim ping dan mengembalikan status yang dijawab server-mu, {"act":"delete","id":…} menghapusnya.Bisa dibaca mesin: spesifikasi OpenAPI 3.1 dengan skema request dan response lengkap · referensi interaktif tempat kamu bisa langsung mengirim panggilan · changelog (JSON).
Order tereksekusi seketika di harga live sungguhan (feed multi-exchange - harga yang sama dengan Paper Trade kami). Eksekusi lewat API tanpa slippage (eksekusi di situs web-nya sendiri kena slippage), jadi anggap harga entry sedikit optimis.
Setiap posisi membayar biaya taker di kedua sisi, diselesaikan ke pnl_usd saat penutupan. Biaya dikenakan sebagai bolak-balik: fee = qty × (entry + exit) × rate. Funding diakumulasi pada posisi yang ditahan melewati jam funding dan dipotong dengan cara yang sama. Posisi terbuka sudah menampilkan P&L bersih dari biaya bolak-balik di unrealized_pnl_usd, jadi yang kamu lihat itulah yang diselesaikan.
| Market | Biaya per sisi | Pulang-pergi pada nilai nosional $10,000 |
|---|---|---|
| Perp kripto | 0.055% | $11.00 |
| Saham & ETF | 0.02% | $4.00 |
| Logam & indeks | 0.015% | $3.00 |
| Forex mayor | 0.008% | $1.60 |
Mau tagihan persis dari exchange yang akan kamu pakai? Kenakan akun paper dengan jadwal biayanya, termasuk diskon referral. Di atas sekitar leverage 180×, rate-nya mengecil supaya biaya bolak-balik tidak pernah melebihi 20% margin-mu. GET /v1/markets mengembalikan rate persis dan batas leverage untuk setiap simbol. Strategi jangka pendek hidup atau mati karena angka ini - scalp yang untungnya di bawah biaya bolak-balik tetap rugi, sesering apa pun tebakannya benar.
Isolated margin. Kerugian dibatasi sebesar margin-mu. Harga likuidasi memakai rasio maintenance margin 0.5%; saat harga live menembusnya, posisi otomatis diselesaikan di harga likuidasi. Order stop-loss dan take-profit juga tereksekusi otomatis - saat harga menembus sl atau tp-mu (dicek terhadap sumbu candle 1 menit pada sweep per menit, jadi lonjakan yang sudah balik pun tetap dihitung), posisi diselesaikan di level itu. Trailing stop bergeser mengikuti harga terbaik yang pernah tercapai: pada sweep, ia digeser oleh titik ekstrem tiap candle setelah candle itu dicek terhadap stop yang berlaku, jadi sebuah bar tidak pernah bisa menghentikanmu di level yang ia ciptakan sendiri.
Setiap akun paper dimulai dengan nominal $10,000. /v1/account dan /v1/balance melaporkan balance_usd, equity_usd dan free_margin_usd supaya kamu bisa menyatakan hasil sebagai return, bukan sekadar angka dolar. Saldo ini papan skor, bukan batasan: margin tidak dipotong darinya dan posisi baru tidak pernah ditolak karena dana kurang (margin_enforced: false). Atur sendiri ukuran posisimu kalau kamu mau batasannya terasa nyata.
Setiap respons membawa X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset (detik epoch); respons 429 menambahkan Retry-After. Batas dihitung per key, jadi key kedua punya kuotanya sendiri. X-RateLimit-Scope menyebut apakah batas key atau batas per-IP yang berlaku.
Posisi yang dibuka lewat API tersimpan di akunmu di sisi server, jadi muncul di My Trades, dihitung untuk papan musim dan XP, dan masuk ke laporan trading-mu - laporan yang sama yang dikembalikan GET /v1/report ke bot.
Menaruhnya di balik paywall akan mendorong semua orang kembali ke polling, yang jauh lebih mahal bagi kami dibanding stream - jadi kepentingannya sejalan: pakai WebSocket, kita sama-sama untung. Data pasar tetap tanpa key dan gratis selamanya; key hanya menaikkan batasnya.
Ada dua hal di mesin ini yang sengaja dibuat longgar, dan lebih baik kami sebutkan daripada kamu temukan sendiri di akun live. Market order tereksekusi di harga live, jadi posisi baru menunjukkan 0.00 belum terealisasi dan garis entry ada persis di tempat yang kamu minta. Dan maintenance margin datar 0.5%, berapa pun nilai posisinya. Untuk belajar trading, keduanya pilihan yang tepat. Untuk membuktikan sebuah strategi, keduanya terlalu optimis, dan makin besar ukurannya makin optimis.
Jadi ini sakelar, bukan asumsi. Default-nya off - tidak ada yang sudah kamu bangun yang ikut bergeser - dan saat on, harga eksekusi dan harga likuidasi berperilaku seperti yang dibentuk order book sungguhan dan tabel risk-limit sungguhan.
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}
Eksekusi bergeser melawanmu sebesar ongkos menembus order book sungguhan: 0.01% di koin mayor, 0.05% di kripto yang lebih tipis, 0.005% di forex, 0.02% di saham, logam, dan indeks. Beli membayar lebih mahal, jual menjual lebih murah - tidak pernah sebaliknya.
Maintenance margin naik seiring ukuran nosional, seperti tabel risk limit di exchange, jadi posisi besar kena likuidasi lebih cepat - kebutuhan maintenance yang lebih tinggi menoleransi pergerakan berlawanan yang lebih kecil sebelum menutupmu, persis yang diinginkan venue untuk ukuran besar. Ini model yang kami publikasikan, bukan tabel milik satu venue tertentu, dan GET /realism mengembalikan seluruh tangganya - kamu tidak perlu menebak-nebaknya dari harga likuidasi.
Rasio maintenance margin yang dipublikasikan venue mana yang mau dipakai: Binance 0.40%, Bybit 0.50%, MEXC 0.10%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%. Ini hanya menggeser letak harga likuidasi - tidak pernah ukuran, biaya, atau P&L.
Tiga ini hanya sebagian. Seluruh simulasi bisa dikonfigurasi - ukuran book dan apakah itu anggaran sungguhan, angka slippage dan biaya versimu sendiri, dampak ukuran, latensi, eksekusi parsial, penolakan, dan funding - dan delapan preset mengaturnya dalam satu panggilan. Posisi tetap memakai maintenance margin saat ia tereksekusi, jadi menyalakan fitur ini tidak pernah mengubah trade yang sedang kamu pegang, dan setiap penutupan mencatat pengaturan yang dipakainya. Dari situlah kolom Fills di arena berasal - papan yang memeringkat bot sepatutnya memberi tahu mana yang memakai mode mudah.
Tiga sakelar di atas adalah bagian dari sesuatu yang lebih besar. Semua yang diasumsikan mesin ini adalah field yang bisa kamu atur: ukuran book dan apakah itu anggaran sungguhan, berapa ongkos menembus order book saat masuk dan saat keluar, berapa lama order-mu dalam perjalanan, apakah order tereksekusi sebagian, seberapa sering venue menolak, berapa biaya yang kamu bayar, apakah funding dikenakan sama sekali, dan di mana harga likuidasi berada.
Pengaturan default-nya sengaja dibuat mudah, dan itu perlu dikatakan terus terang. Market order tereksekusi penuh di harga live, maintenance margin datar 0.5%, saldo hanyalah papan skor yang tidak pernah menolak posisi baru, dan tidak ada latensi maupun dampak ukuran. Itu tempat yang tepat untuk membuat bot berjalan. Tapi tempat yang salah untuk menilai apakah bot-nya punya keunggulan. Satu panggilan mengubah itu.
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"}
Nilai di luar rentang ditolak, tidak pernah dipangkas - strategi tidak boleh diukur dengan pengaturan yang tidak kamu pilih. Posisi tetap memakai maintenance margin, rate biaya, dan ongkos menembus spread saat keluar yang berlaku ketika ia tereksekusi, seumur hidupnya; menyalakan apa pun tidak pernah mengubah trade yang sedang kamu pegang.
Engine seperti yang selama ini ada. Jalankan bot-nya, lihat trade masuk, lalu ubah.
Yang dipakai untuk mengukur edge: order book memungut biaya sesuai yang kami ukur di kedua sisi, ukuran besar lebih mahal, tangga risk-limit aktif, funding dikenakan, dan akun menolak apa yang tidak bisa didanainya.
Biaya taker dan maintenance margin yang dipublikasikan venue itu sendiri, dengan ongkos menembus spread hasil pengukuran kami, margin yang ditegakkan, dan tangga yang aktif.
Perp mid-cap di jam yang tidak bersahabat, lalu lebih buruk dari apa pun yang akan kamu temui: 60 bps untuk menembus spread, 120 bps per $100k ukuran, eksekusi mulai dari seperempat ke atas, satu dari dua puluh posisi ditolak, latensi satu detik. Angka versi kami, bukan angka venue mana pun. Kalau strategi masih jalan di sini, berarti ia tidak hidup dari keberuntungan eksekusi.
| Field | Rentang | Fungsinya |
|---|---|---|
| Akun — apa yang boleh dipertaruhkan bot | ||
start_balance_usd | 100 – 10,000,000 | Book yang menjadi tolok ukur hasilmu: return_pct, kurva ekuitas, dan drawdown maksimum semuanya mengikutinya. Uji dengan ukuran akun yang benar-benar akan kamu tradingkan. |
margin_enforced | mati / nyala | Perbedaan terbesar antara papan skor dan venue. Saat aktif, posisi baru yang butuh lebih dari margin bebasmu ditolak dengan 402 insufficient_margin. Margin bebas adalah saldo dikurangi margin yang terpakai — profit belum terealisasi di posisi terbuka bukan jaminan untuk posisi baru, karena setiap posisi di sini memakai isolated margin. |
leverage_max | 0 – 10,000 | Batasmu sendiri di bawah batas per market. Membuktikan strategi tidak pernah diam-diam bergeser ke 100×. 0 = batas market. |
max_notional_usd | 0 – 1,000,000,000 | Batasmu sendiri untuk nilai nosional satu posisi. 0 = tanpa batas sendiri. |
| Eksekusi — berapa ongkos menembus order book | ||
slippage | mati / nyala | Eksekusi bergeser melawanmu seperti saat menembus order book sungguhan: 0.01% di kripto mayor, 0.05% di kripto yang lebih tipis, 0.005% di forex, 0.02% di saham, logam, dan indeks. Beli membayar lebih mahal, jual menjual lebih murah. |
slippage_bps | 0 – 500 | Angkamu sendiri sebagai ganti tabel itu. 10 = 0.10%. null kembali ke tabel. |
impact_bps_per_100k | 0 – 500 | Ukuran besar lebih mahal, karena order yang lebih besar menembus order book lebih dalam: sekian basis point tambahan per $100,000 nilai nosional. |
exit_slippage | on / off | Bayar ongkos menembus spread saat keluar juga, bukan hanya saat masuk. Tanpa itu, strategi scalping terlihat lebih bagus daripada yang mungkin dicapainya. Stop, take-profit, atau likuidasi tetap tereksekusi di level-nya sendiri — lihat batasannya di bawah. |
latency_ms | 0 – 2,000 | Order-mu dalam perjalanan selama ini, dan harganya dibaca ulang sesudahnya — jadi eksekusinya mengikuti pasar saat order-mu tiba, bukan saat kamu mengirimnya. |
partial_fills | mati / nyala | Market order bisa tereksekusi lebih sedikit dari yang diminta. Ukuran yang tereksekusi ada di position.margin_usd; rasionya ada di header X-MP-Fill-Pct dan objek fill di v2. |
min_fill_pct | 10 – 100 | Rasio terburuk yang bisa kamu terima. 40 berarti di mana saja antara 40% sampai 100% dari yang kamu minta. |
reject_rate_pct | 0 – 50 | Porsi posisi baru sebesar ini sengaja ditolak dengan 503 venue_rejected. Bot yang tidak bisa menangani penolakan belum selesai, dan di sinilah tempat murah untuk mengetahuinya. |
| Biayanya | ||
taker_bps | 0 – 100 | Biaya per sisi milikmu sendiri sebagai ganti jadwal venue. 5.5 = 0.055%. Pengurangan untuk leverage tetap berlaku, jadi tidak ada setelan yang bisa membuat biaya pulang-pergi menghabiskan seluruh modal. |
funding | on / off | Off, funding tidak pernah dikenakan. Dengan ini kamu bisa membedakan edge eksekusi dari edge carry — short yang ditahan saat funding positif mungkin untung hanya karena funding-nya. |
funding_mult | 0 – 5 | Skalakan rate 8 jam yang sesungguhnya. |
| Likuidasi | ||
margin_venue | 10 venue | Rasio maintenance margin yang dipublikasikan venue mana yang menentukan posisi harga likuidasi. Binance 0.40%, Bybit 0.50%, MEXC 0.10%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%. Ini hanya menggeser harga likuidasi. |
margin_tiers | mati / nyala | Maintenance margin naik seiring nilai nosional seperti tangga risk limit, jadi posisi besar kena likuidasi lebih cepat. Seluruh tangganya dipublikasikan di GET /v2/realism. |
mmr_pct | 0.05 – 10 | Maintenance margin versimu sendiri, mengalahkan margin_venue dan default kami. |
Stop-loss, take-profit, atau likuidasi tereksekusi di level-nya sendiri dan tidak pernah membayar ongkos menembus spread: sweep di sisi server berjalan atas semua akun sekaligus dan tidak bisa membaca profil per putaran. Tidak ada order book dengan kedalaman sungguhan di balik model dampak — impact_bps_per_100k adalah biaya linear yang dideklarasikan, bukan order book simulasi. Dan seluruh ongkos menembus spread saat keluar dikenakan terhadap mark price, yaitu satu spread, bukan bid dan ask yang bisa kamu kutip terpisah. Semua hal lain di atas diterapkan persis seperti tertulis.
Setiap angka di profil ini bisa dibaca kembali dari GET /api/bot/v2/sim, termasuk seperti apa eksekusi kalau terjadi sekarang — angka yang tidak bisa dibaca kembali oleh bot adalah angka yang harus ditebaknya. GET /api/bot/v2/report lalu memberitahumu berapa sebenarnya ongkos eksekusi: biaya, funding, kotor dibanding bersih, dan kept_pct, porsi hasil kotor yang tersisa. Yang satu itu gratis di setiap paket, karena itu bukan rincian di mana keunggulanmu berada — tapi apakah keunggulan itu nyata.
Secara default, setiap eksekusi paper membayar rate MarginPad: 0.055% per sisi untuk kripto, di kedua kaki, dikenakan sebagai biaya bolak-balik saat penutupan. Itu rata-rata yang wajar, tapi bukan tagihan persis siapa pun. Kalau kamu sudah tahu di mana bot akan berjalan sungguhan, kenakan akun paper dengan jadwal biaya venue itu - rate taker yang dipublikasikannya, dikurangi diskon referral yang didapat pendaftar MarginPad di sana - supaya forward test diselesaikan dengan cara yang sama seperti akun live nanti:
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
| Venue | Taker | Diskon referral kami | Kamu bayar per sisi |
|---|---|---|---|
| Bybit | 0.055% | 20% | 0.044% |
| Binance | 0.050% | 20% | 0.040% |
| Bitget | 0.060% | 20% | 0.048% |
| Gate | 0.050% | 20% | 0.040% |
| Hyperliquid | 0.045% | 4% (kode MARGINPAD) | 0.0432% |
| OKX · Kraken | 0.050% | - | 0.050% |
| MEXC | 0.020% | - | 0.020% |
| KuCoin | 0.060% | - | 0.060% |
| Default MarginPad | belum ada venue dipilih | 0.055% | |
Tarifnya adalah tier dasar yang dipublikasikan tiap exchange plus diskon yang kami cantumkan di /exchanges/; API mengembalikannya dengan source supaya kamu tahu itu angka yang diiklankan, bukan hasil ukur. Kedua sisi membayar tarif taker (paper engine mengeksekusi di harga market; rebate maker untuk entry yang menunggu tidak dimodelkan). Hanya perp kripto - saham, forex, logam, dan indeks tetap memakai tarif kelas MarginPad apa pun exchange-nya. Posisi terbuka mempertahankan tarif saat dieksekusi; batas untuk leverage ekstrem (biaya pulang-pergi tidak pernah lebih dari 20% margin) tetap berlaku. Pilihan yang sama ada di selektor "Fees as on" pada form Paper Trade, jadi bot dan trade manual pemiliknya membayar biaya yang persis sama.
Selalu kirim client_order_id saat membuka posisi. Ini satu baris paling penting di dokumentasi ini. Tanpanya, request yang timeout di jaringan membuatmu menebak-nebak: posisinya terbuka atau tidak? Coba lagi, dan kamu bisa punya dua. Dengan itu, retry mengembalikan posisi yang dibuat panggilan pertama, ditandai 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}}
Pakai nilai yang bisa dihasilkan ulang strategimu secara deterministik - id sinyal, atau simbol plus timestamp candle. Id diingat selama 7 hari.
Penutupan juga butuh itu. Kirim client_order_id di /close dan retry akan melaporkan apa yang dilakukan panggilan pertama (idempotent: true), bukan error yang harus kamu tafsirkan sendiri.
Kirim symbol saat kamu menutup posisi. Setiap baris /positions sudah membawanya, jadi menambahkannya gratis dan terbukti mempercepat penutupan:
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
Penyimpanan trading kami adalah satu instance yang terkunci di satu region, jadi setiap hop tambahan memakan waktu sebesar perjalanan bolak-balik ke sana dari lokasimu. Diukur pada 2026-08-19: sekitar 20 ms dari Eropa tapi median 198 ms dan 368 ms di persentil ke-95 dari Singapura. Feed harga yang dingin menambah sekitar 400 ms lagi, dan tanpa petunjuk itu, penutupan di pair likuid bisa ikut menunggu pair yang tidak likuid dalam batch yang sama. Dengan petunjuk itu, penutupan cukup satu hop plus satu harga yang sudah hangat. symbol yang salah atau usang tidak merugikan apa pun - server mendeteksinya dan beralih ke cara biasa.
Jangan habiskan jatah rate-mu untuk polling. Kebanyakan bot memakai sebagian besar panggilannya untuk bertanya "ada yang berubah?". Dua hal membuat itu nyaris gratis:
# 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
ETag mencakup status struktural - id posisi, status, kuantitas, stop, target, exit - dan sengaja tidak mencakup mark price, yang bergerak tiap tick dan akan membuat ETag tidak pernah cocok. Jadi: polling /positions untuk "apakah stop-ku sudah kena", polling /price yang tanpa key untuk P&L. Pantau X-RateLimit-Remaining dan mundur sesuai Retry-After.
Posisi dan harga dikirim ke kamu, jadi kamu tahu stop-mu kena dalam beberapa detik, bukan saat polling berikutnya:
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"}
Event: position dengan event: opened | updated | closed terpicu saat sesuatu benar-benar berubah - eksekusi, stop yang bergeser, penutupan, likuidasi. prices membawa mark price simbol terbukamu di tiap tick. Pergerakan mark price saja tidak pernah memicu event position, jadi channel tetap sepi kalau tidak ada yang terjadi.
Stop diselesaikan lebih cepat selama kamu terhubung. Stream menjalankan sweep SL/TP/likuidasi sisi server yang sama dengan yang dipakai jalur REST, dengan ritme ~2 detik, alih-alih menyerahkan posisimu ke sweep berkala.
Maksimal 3 socket bersamaan per akun, dibagi di semua key-mu. Socket didaur ulang setiap 6 jam - sambungkan lagi dan kamu dapat snapshot baru. Kalau koneksi putus, anggap snapshot berikutnya sebagai kebenaran, bukan memutar ulang event yang terlewat.
Diukur selama 40 hari terakhir: 76.4% dari semua panggilan ke API ini adalah polling ke /positions dan /account untuk mencari event yang belum terjadi. Webhook membaliknya - kami mem-POST ke kamu saat sesuatu benar-benar terjadi, dengan bentuk Position yang sama seperti hasil polling, dan tetap bekerja saat bot-mu offline, sedang restart, atau di-deploy di tempat yang tidak bisa menahan 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",…}}
Event yang tersedia: position.opened · position.updated (stop atau target yang bergeser) · position.closed · position.liquidated · order.filled (membawa posisi yang dibuatnya) · order.expired · order.cancelled. Kosongkan events untuk menerima semuanya. Trade dari website di akun yang sama juga akan memicu event ini.
Verifikasi setiap pengiriman. X-MP-Signature adalah sha256=HMAC_SHA256(secret, raw body) dengan secret yang kamu terima saat menambahkan hook. Bandingkan sebelum mem-parse body; kedua SDK menyertakan verify_webhook / verifyWebhook. Balas dengan 2xx dalam 6 detik - selain itu akan dicoba ulang 5 kali dengan backoff (30 detik, 1, 2, 4 menit), dan hook dijeda setelah 25 kegagalan beruntun; GET /webhooks menampilkan active, consecutive_failures, dan last_error supaya kamu tahu penyebabnya. 15 hook per akun di API Premium; pengiriman bersifat best-effort, snapshot WebSocket dan /positions tetap jadi sumber kebenaran.
Coba dulu sebelum kamu menulis penerima: daftarkan https://marginpad.io/api/whsink/<any-token-you-choose> sebagai URL, lalu buka GET di alamat yang sama - ia menampilkan ulang 20 pengiriman terakhir (header dan body) selama 15 menit. Tanpa autentikasi; token itulah rahasianya.
Book adalah jurnal, saldo, report, dan kurva ekuitas terpisah di dalam akunmu. Buat key dengan nama book dan setiap panggilan dengan key itu akan trading di book tersebut; akun utama dan book lainnya tidak melihatnya. Akun gratis dapat satu book selain akun utama, API Premium 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
Reset ditolak dengan 409 open_positions_exist selama masih ada yang terbuka: tutup dulu, baru reset. Trade yang diarsipkan tetap disimpan (tidak pernah dihapus), tapi laporan, ledger, /trades, dan kurva ekuitas mulai dari titik reset, dan browser yang masih menyimpan jurnal lama tidak bisa mendorongnya kembali. Webhook terkirim lewat hook milik akun dengan "account":"rsi" di payload, jadi satu penerima melayani semua book.
Backtest dengan kode yang sama yang akan kamu jalankan live. Mulai replay satu hari UTC di masa lalu, dan route yang sama yang sudah dipanggil bot-mu akan bekerja di jurnal replay terpisah, dengan harga dari candle 1 menit milik MarginPad sendiri di posisi kursor. Stop, target, dan likuidasi dicek di setiap candle di antara dua panggilanmu, di high dan low-nya, dengan hitungan biaya dan funding yang sama seperti live. Tidak ada hasil replay yang masuk ke papan peringkat, arena, atau laporanmu.
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
Kecepatan dari 1 (real time) sampai 600 (sehari dalam 2.4 menit). Satu replay per key dalam satu waktu, kripto saja, untuk sekarang hanya market order: baca harga dan candle replay dari GET /v1/replay, karena /v1/price dan /v1/klines yang tanpa key tetap menjawab dengan data live.
Kamu bisa punya beberapa key di satu akun - pisahkan bot backtest dan bot live, dan cabut satu tanpa menyentuh yang lain. Pemakaian dan rate limit dihitung per key, jadi masing-masing punya jatah sendiri dan barisnya sendiri di statistikmu. Saat masuk di situs, dari browser:
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
Key yang sudah dicabut mengembalikan 401 revoked_key. Key bersifat rahasia - siapa pun yang memegangnya bisa trading di akun paper-mu. Buat dan cabut key di bagian atas halaman ini.
Setiap akun atau book dengan minimal lima posisi tertutup yang dibuka lewat API di musim 14 hari ini diperingkat di /arena/ berdasarkan P&L terealisasi setelah biaya dan funding, dengan win rate, return terhadap papan skor $10,000, rata-rata ROE, dan jumlah likuidasi. Tanpa hadiah dan tanpa perlu mendaftar: trading lewat API dan papan itu otomatis memasukkanmu. JSON: GET /api/arena.
MarginPad menjalankan server MCP remote, jadi asisten AI bisa membaca pasar dan trading di akun paper-mu secara langsung - tanpa kode perekat:
https://marginpad.io/mcp
Tambahkan sebagai server MCP remote di klienmu dan set header X-API-Key: mpb_… kalau kamu mau tool paper trading. Tool data market tidak butuh key. Ada dua puluh delapan tool: harga, candle, market, screener, funding, open interest, likuidasi, fear and greed, kalender ekonomi, dua kalkulator, dan paper open (dengan trailing stop dan dry run) / limit dan stop order / modify / cancel / close / sltp / positions / orders / balance / trades / report / fees / accounts / reset / equity / replay. GET /mcp di browser mengembalikan deskriptor server.
/api/bot/v1/* sudah dibekukan. Body responsnya tidak akan berubah; bot yang ditulis untuknya tetap jalan tanpa batas waktu, dan tetap menerima perbaikan kebenaran.
/api/bot/v2/* adalah API yang sama dengan envelope yang sudah dipakai endpoint data kami - satu bentuk yang bisa ditebak untuk sukses maupun gagal, jadi kamu cukup menulis parsing-nya sekali:
{ "ok": true, "data": { ... }, "ts": 1787200000000 }
{ "ok": false, "error": { "code": "unknown_symbol", "message": "No price feed for that symbol...", "symbol": "FOO" }, "ts": 1787200000000 }
Path sama, parameter sama, key sama - ganti v1 dengan v2 di URL. Nilai code pada error adalah identifier yang stabil; message untuk dibaca manusia dan bisa diubah redaksinya.
Di /v2, kegagalan selalu berbentuk {"ok":false,"error":{"code","message"},"ts"}. code adalah identifier stabil yang bisa kamu jadikan percabangan; message berupa kalimat dan bisa diubah redaksinya. Sebagian error menyertakan nilai yang kamu butuhkan untuk memperbaiki panggilan - sl_wrong_side dan tp_wrong_side menyertakan harga live.
| Kode | HTTP | Yang harus dilakukan |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Kirim key yang valid di X-API-Key. |
revoked_key | 401 | Buat key baru; key ini sudah dicabut. |
rate_limit | 429 | Tunggu sampai Retry-After. Jangan langsung retry. |
unknown_symbol | 404 | Cek /v1/markets. |
symbol_required, margin_usd_min_1, margin_usd_max_100000, id_required | 400 | Perbaiki body request. |
sl_wrong_side / tp_wrong_side | 400 | Response membawa live - taruh level-nya di sisi yang benar dari harga itu. |
stop_wrong_side | 400 | Stop entry menunggu di sisi breakout (long di atas, short di bawah). Pakai type:"limit" untuk entry pullback. |
trail_pct_invalid | 400 | trail_pct adalah persen antara 0.05 dan 50; nilai di luar itu ditolak, tidak pernah diam-diam dipangkas. |
nothing_to_modify | 400 | /modify_order butuh minimal satu field. |
plan_required | 402 | Webhook butuh paket berbayar. Semua yang lain di halaman ini ada di Free. Body-nya membawa plan_needed. |
premium_required | 402 | Kode lama untuk plan_required, masih dikirim supaya bot 2.3 tetap mengenalinya. |
too_many_webhooks | 409 | Hapus satu dulu - 15 hook di API Premium. |
bad_url / bad_event | 400 | URL webhook harus https di host publik; nama event tercantum di GET /webhooks. |
too_many_open | 409 | Posisi terbukamu sudah mencapai batas plan. Tutup salah satu. |
already_closed | 400 | Aman saat retry - posisinya sudah diselesaikan. |
no_price | 400 | Tidak ada harga live saat ini; posisi tetap terbuka. Coba lagi. |
unavailable | 503 | Sementara. Coba lagi dengan backoff. |
Masih buntu? Body error adalah tempat pertama untuk dilihat, dan status yang kedua. Kalau keduanya tidak menjawab, tulis ke support@marginpad.io dengan endpoint dan body persis yang kami kirim balik - apa lagi yang perlu disertakan ada di halaman support. Yang membacanya manusia.
Likuidasi real-time yang dihimpun dari dua belas exchange oleh collector kami sendiri - data di balik feed Rekt dan Liquidation Heatmap kami, tersedia sebagai JSON gratis. Data sejenis biasanya dikunci paywall seharga $300+/bulan di tempat lain; di sini sama sekali tidak butuh API key. Di-cache di edge dan dibatasi rate-nya, jadi aman dipakai bot yang polling.
{events:[{ts, exchange, symbol, side, price, qty, notional}]}. Event masuk ke sini beberapa detik setelah terjadi (cache edge 3 dtk). Polling setiap 3-5 dtk.side berisi long_liquidated atau short_liquidated, notional adalah ukuran dalam USD.minutes: sampai 43200 (30 hari).{clusters:[{price, side, est_notional}]}. Terus diperbarui dari order flow live.Atribusi dihargai (link ke marginpad.io) tapi tidak wajib. Cakupannya ~70%+ dari arus likuidasi pasar - venue-venue yang menggerakkan harga. Untuk keperluan edukasi; tanpa SLA uptime. Cuma butuh data pasar? Seluruh endpoint tanpa key didokumentasikan di halaman API data kripto gratis.
Sebagian besar bot trading kripto yang terlihat untung di backtest rugi di minggu pertama saat dijalankan live. Backtest memutar ulang candle historis yang bersih - backtest tidak bisa menangkap race condition di logika order-mu, bug ukuran posisi yang baru muncul setelah rentetan kekalahan, atau leverage yang diam-diam membesar melebihi daya tahan margin-mu. Forward testing menjalankan bot yang sama, jalur kode yang sama, terhadap harga live sungguhan secara real-time. Kalau strateginya punya cacat, cacat itu muncul di sini, tempat bug tidak membuatmu rugi apa pun.
| Backtesting | Paper trading (API ini) | Trading live | |
|---|---|---|---|
| Harga | Candle historis | Harga live sungguhan, real-time | Harga live sungguhan |
| Risiko | Tidak ada | Tidak ada - dolar simulasi | Uang sungguhan dipertaruhkan |
| Menangkap bug logika | Jarang - data replay menyembunyikannya | Ya - jalur kode sama dengan live | Bisa, tapi setiap bug memakan uang |
| Cek overfitting | Tidak - kamu menyetel di data ini | Ya - data masa depan yang belum pernah dilihat | Ya |
| Biaya | Gratis | Gratis dipakai - biaya & funding disimulasikan | Biaya + rugi + funding |
| Cocok untuk | Menyaring ide dengan cepat | Membuktikan bot sebelum mengisinya dengan dana | Strategi yang sudah terbukti dua kali |
Langkah tengah adalah yang paling sering dilewati orang - padahal itulah yang bisa menyelamatkan mereka. Backtest idenya di sini, forward-test di API ini, baru danai akun.
Semua di halaman ini diselesaikan dalam dolar simulasi. Setelah bot bertahan berminggu-minggu dalam forward testing, kode yang sama butuh API exchange untuk memasang order sungguhan. Ada dua venue yang kami sarankan untuk pembuat bot, dengan alasan berbeda:
Perp di chain mereka sendiri dengan API REST dan WebSocket publik, sub-akun yang masing-masing punya API wallet sendiri (bot tidak pernah memegang key utamamu), funding per jam, dan order book yang bisa diaudit siapa pun on-chain. Yang paling mendekati menjalankan bot terhadap API ini dengan uang sungguhan.
Bentuk REST dan WebSocket yang mirip dengan yang barusan kamu tulis, key terpisah untuk tiap sub-akun, dan salah satu feed sumber harga kami sendiri. Pilihan default kalau kamu mau order book terpusat dengan jalur masuk fiat.
Buka akun Bybit →Ya - MarginPad menyediakan likuidasi real-time yang dihimpun dari 8 exchange sebagai JSON gratis, tanpa key: /api/v1/feed, /api/v1/liquidations/live, /api/v1/liquidations/recent dan /api/v1/clusters. Feed sejenis biasanya $300+/bulan. Lihat bagian data likuidasi.
Ya. Ini simulator paper trading - posisi memakai harga pasar live yang asli tapi tanpa uang sungguhan. Masuk dengan email, buat API key, dan langsung mulai menguji, tanpa batas waktu dan tanpa kartu. API Premium menambahkan arsip pasar kami, ladder order book mentah, dan webhook untuk membangun di atasnya.
Bahasa apa pun yang bisa membuat request HTTPS - Python, JavaScript/Node.js, Go, Rust, PHP, atau curl biasa. REST standar, response JSON, satu header X-API-Key.
Pair USDT apa pun yang punya harga live di exchange besar - BTC, ETH, SOL, dan ratusan altcoin, plus saham AS, forex mayor, logam, dan indeks sebagai perp. Cek simbol dengan GET /api/bot/v1/price?symbol=SOL.
Tidak. Tanpa deposit, tanpa wallet, tanpa KYC. Kamu cukup masuk dengan email supaya API key dan posisimu tersimpan antar-sesi.
Tidak. Bot API punya paket sendiri dan langganan Premium tidak mengubah batas API apa pun. Premium membuka fitur di situs web; paket API membuka batas API. Keduanya dibeli terpisah.
Bangun bot yang berfungsi dengan Python dan arahkan ke API ini - kode lengkap: feed harga, strategi EMA-cross, order buka/tutup, dan loop-nya.
Bot yang sama dalam JavaScript - kode Node.js lengkap tanpa dependensi, diarahkan ke API ini.
Alur kerja tiga tahap yang membedakan bot yang berhasil dari akun yang hancur: backtest, paper trading, lalu live.
Cara kerja bot grid, kapan menang dan kapan meledak, serta cara forward-test sebelum mengisinya dengan dana.
Apa yang dibuktikan setiap tahap pengujian, dan urutan persis untuk memakainya.
Strategi berbantuan AI yang benar-benar tahan uji - dan cara mengujinya tanpa risiko sebelum diotomatisasi.