API Paper Trading Kripto Gratis - Uji Bot Trading-mu | MarginPad
MARGINPAD
Harga live · eksekusi di server · tanpa deposit

Exchange yang boleh dirusak bot-mu tanpa rugi.

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.

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

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

Ambil key-mu

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.

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.

Paket

Plan Gratis sudah cukup untuk menguji bot. API Premium untuk membangun di atasnya.

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.

Free

$0 selamanya

Semua yang kamu butuhkan untuk menguji bot: seluruh engine, stream, replay, dan data pasar live. Tanpa kartu, tanpa trial, tanpa hitung mundur.

Uji strategi dari awal sampai akhirsatu book · satu jurnal · engine lengkap
  • 3 key · 50 posisi terbuka · 120 req/menit
  • Engine lengkap: market, limit & stop order, trailing stop, dry run, replay
  • Simulasi yang bisa dikonfigurasi - biaya, slippage, latensi, eksekusi sebagian - dan 9 exchange asli
  • Stream WebSocket · MCP · data pasar live tanpa key
  • Trading report: total, skill score, dan berapa biaya serta funding yang kamu keluarkan
  • Riwayat trade 30 hari

API Premium

UNTUK MEMBANGUN
$11.99/bulan

Untuk membangun sesuatu yang serius: backtest di riwayat terukur kami, bereaksi lewat webhook, jalankan beberapa strategi berdampingan.

Arsip pasar, lewat APIsetiap likuidasi sejak Juli 2026 · open interest · funding · trade whale · long/short
  • Arsip pasar di /v1/history - 9 dataset, satu CSV terverifikasi per hari UTC
  • Ladder order book mentah per exchange
  • 20 book · 15 webhook bertanda tangan
  • Riwayat trade 90 hari, rincian report, dan temuan tertulis
  • 30 key · 500 posisi terbuka · 2000 req/menit
Apa yang berubah sesuai paketFreeAPI Premium · $11.99
Arsip pasar /v1/history
liquidations, agg5m, oi, funding_oi, whale_fills, whale_pos, catalysts, longshort, mpad
katalogsetiap hari, setiap dataset
Ladder order book mentah per exchangehanya book gabunganya
Book - jurnal, saldo, dan report terpisah untuk tiap strategi120
Webhook - bertanda tangan, dengan retry, dikirim saat kamu sedang offlinetidak ada15
Riwayat trade disimpan
yang masih bisa dilihat /v1/trades, laporan, dan kurva ekuitas
30 hari90 hari
Laporan trading /v1/reporttotal, skill score, biaya+ rincian & temuan
API key · posisi terbuka3 · 5030 · 500
Request per menit, per key (engine dan /api/v1/* dengan key)
60 / menit per IP tanpa key, di semua plan
1202000

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.

Mulai cepat

Tiga panggilan dari nol sampai posisi live

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.

LANGKAH 01

Baca pasar

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.

LANGKAH 02

Buka posisi

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.

LANGKAH 03

Biarkan ia push, jangan polling

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

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.

26
endpoint, plus WebSocket, webhook, dan server MCP
9
jadwal biaya venue sungguhan yang bisa dikenakan ke eksekusimu
1,000×
leverage maksimum, di pair USDT apa pun yang punya harga live
156
market dalam satu key: perp kripto, saham AS, forex, indeks, dan logam
4.4M
panggilan dilayani untuk bot yang sudah berjalan di atasnya
STATUS store trading pengumpul likuidasi job terjadwal membaca /api/status… Status lengkap dan riwayat →
Kenapa bukan testnet exchange

Testnet memberimu harga palsu. Ini memberimu harga asli dan uang palsu.

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.

Simulasi

Bangun venue yang benar-benar akan kamu tradingkan

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 →

Eksekusi

Server yang memegang order-mu

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.

Biaya

Biaya yang sesuai tagihan sungguhanmu

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.

Kegagalan

Likuidasi yang masuk akal

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.

Idempotensi

Timeout bukan misteri

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.

Observabilitas

Push, bukan polling

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.

Pengukuran

Ia menilai strategimu

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.

Endpoint

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

Data pasar - tanpa key
GET/v1/price?symbol=BTCHarga live untuk pair USDT apa pun. Tanpa key - coba sekarang juga di browser-mu.
GET/v1/klines?symbol=BTC&interval=60Candle OHLC untuk strategimu (interval: 1, 5, 15, 30, 60, 240, 1440 menit). Tanpa key. Sampai 1000 candle per panggilan, yang terbaru di akhir - sekitar 16 jam di 1m, 3 hari di 5m, 10 hari di 15m, 41 hari di 1h, 166 hari di 4h, dan kira-kira 3 tahun di 1d. Kirim &end=<unix ms> untuk mundur lebih jauh.
GET/v1/historyArsip pasar (API Premium). Tanpa parameter, endpoint ini menampilkan daftar semua dataset, kolomnya, serta hari arsip pertama dan terakhir - gratis dibaca dengan key apa pun. ?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.
GET/v1/marketsSemua yang bisa ditradingkan, dengan 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.
GET/v1/time?client_ts=…Jam server. Tanpa key. Kirim unix ms milikmu dan kamu dapat 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
Trading
POST/v1/openBuka posisi simulasi di harga live. Body: {"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.
POST/v1/open trail_pcttrail_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.
POST/v1/open type:"limit"Order menunggu di server alih-alih tereksekusi sekarang: {"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.
POST/v1/open type:"stop"Entry breakout: long di atas harga pasar atau short di bawahnya, misalnya {"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.
POST/v1/closeTutup posisi di harga live. Body: {"id":"bp...","pct":50} - pct opsional (default 100); penutupan parsial memecah posisi persis seperti di situs.
POST/v1/close_allTombol panik - menutup semua posisi terbuka di harga live dalam satu panggilan.
POST/v1/sltpGeser stop-loss, take-profit, atau trailing stop di posisi yang masih terbuka tanpa menutupnya. Body: {"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.
Order tertunda
GET/v1/ordersOrder tertundamu, masing-masing dengan 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.
POST/v1/modify_orderUbah order tertunda di tempat: {"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.
POST/v1/cancel_orderBatalkan satu order tertunda. Body: {"order_id":"lo..."}. Order yang sudah tereksekusi atau dibatalkan menjawab 409, jadi retry tidak pernah bisa membatalkan eksekusi.
Akun dan status
GET/v1/positions?status=openSemua posisimu dengan 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.
GET/v1/accountRingkasan akun: posisi terbuka, margin terpakai, P&L belum terealisasi live, P&L terealisasi sepanjang masa, menang/kalah, win rate, plus balance_usd, equity_usd, free_margin_usd dan return_pct.
GET/v1/balanceHanya soal uang: saldo awal, saldo, ekuitas, margin terpakai, margin bebas, P&L belum terealisasi. Lebih hemat daripada /account kalau hanya itu yang dibutuhkan logika ukuran posisimu.
GET/v1/trades?limit=100&before=…Buku besar lengkap trade yang sudah ditutup, dengan paging. /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.
GET/v1/accountsSetiap book di akun beserta angka sepanjang masanya dan key yang terikat padanya.
GET/v1/equity?days=30&step_min=60Kurva ekuitas book ini, dikelompokkan per interval, dengan max_drawdown_pct dan titik belum terealisasi live di ujungnya.
POST/v1/resetKembalikan book ini ke $10,000 dengan {"confirm":true}: trade tertutup diarsipkan, order dibatalkan. Ditolak dengan 409 open_positions_exist selama masih ada yang terbuka.
GET/v1/usagePaketmu, batas-batasmu, sisa kuota di jendela saat ini, dan usage_30d - jumlah panggilan per hari per endpoint plus refused (yang kena 429), supaya bot bisa melihat seberapa dekat ia berjalan ke batasnya.
Biaya, kecerdasan, dan pengiriman
GET/v1/feesJadwal biaya siapa yang dipakai untuk eksekusimu: venue yang kami modelkan dengan taker, maker, diskon referral kami, dan tarif efektifnya, plus default-mu saat ini. POST {"venue":"bybit"} mengatur default akun; fee_venue di /open menimpanya untuk satu posisi. Lihat biaya per venue.
GET/v1/report?days=30Trading report untuk akun di balik key, dihitung dari trade tertutupnya sendiri: total dan skill score di semua plan; win rate dan return per koin, rentang leverage, sisi, jam, dan hari plus temuan tertulis di API Premium (locked[] menyebut apa yang ditahan). Setiap temuan menyertakan n yang jadi dasarnya dan tidak menyimpulkan apa pun di bawah 8 trade.
GET/v1/webhooksAPI PROEvent trading dikirim ke URL-mu, beberapa detik setelah terjadi, entah bot-mu sedang terhubung atau tidak - lihat webhook. POST {"act":"add","url":"https://…"} mendaftarkan satu, {"act":"test","id":…} mengirim ping dan mengembalikan status yang dijawab server-mu, {"act":"delete","id":…} menghapusnya.
POST/v1/replay2.6Jalankan bot-mu di satu hari UTC yang sudah lewat pada candle 1 menit milik kami sendiri - lihat replay.

Bisa dibaca mesin: spesifikasi OpenAPI 3.1 dengan skema request dan response lengkap · referensi interaktif tempat kamu bisa langsung mengirim panggilan · changelog (JSON).

Cara kerja mesin

Eksekusi dan harga

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.

Biaya trading - baca ini sebelum mengukur strategi

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.

MarketBiaya per sisiPulang-pergi pada nilai nosional $10,000
Perp kripto0.055%$11.00
Saham & ETF0.02%$4.00
Logam & indeks0.015%$3.00
Forex mayor0.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.

Margin, likuidasi, SL/TP, trailing

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.

Saldo dan ekuitas

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.

Header rate limit

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.

Trade bot-mu di situs

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.

API streaming sengaja dibuat gratis

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.

Realisme eksekusi, karena backtest yang memanjakanmu tidak ada nilainya

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}

Slippage

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.

Tingkatan margin

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.

Venue margin

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.

Bangun ulang venue tempat kamu benar-benar akan trading

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.

Delapan preset, jadi kamu tidak perlu mengarang delapan belas angka

frictionless

Engine seperti yang selama ini ada. Jalankan bot-nya, lihat trade masuk, lalu ubah.

realistic

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.

binance · bybit · okx · hyperliquid

Biaya taker dan maintenance margin yang dipublikasikan venue itu sendiri, dengan ongkos menembus spread hasil pengukuran kami, margin yang ditegakkan, dan tangga yang aktif.

thin_book · brutal

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.

Setiap field, rentangnya, dan apa yang diubahnya

FieldRentangFungsinya
Akun — apa yang boleh dipertaruhkan bot
start_balance_usd100 – 10,000,000Book 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_enforcedmati / nyalaPerbedaan 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_max0 – 10,000Batasmu sendiri di bawah batas per market. Membuktikan strategi tidak pernah diam-diam bergeser ke 100×. 0 = batas market.
max_notional_usd0 – 1,000,000,000Batasmu sendiri untuk nilai nosional satu posisi. 0 = tanpa batas sendiri.
Eksekusi — berapa ongkos menembus order book
slippagemati / nyalaEksekusi 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_bps0 – 500Angkamu sendiri sebagai ganti tabel itu. 10 = 0.10%. null kembali ke tabel.
impact_bps_per_100k0 – 500Ukuran besar lebih mahal, karena order yang lebih besar menembus order book lebih dalam: sekian basis point tambahan per $100,000 nilai nosional.
exit_slippageon / offBayar 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_ms0 – 2,000Order-mu dalam perjalanan selama ini, dan harganya dibaca ulang sesudahnya — jadi eksekusinya mengikuti pasar saat order-mu tiba, bukan saat kamu mengirimnya.
partial_fillsmati / nyalaMarket 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_pct10 – 100Rasio terburuk yang bisa kamu terima. 40 berarti di mana saja antara 40% sampai 100% dari yang kamu minta.
reject_rate_pct0 – 50Porsi 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_bps0 – 100Biaya 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.
fundingon / offOff, 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_mult0 – 5Skalakan rate 8 jam yang sesungguhnya.
Likuidasi
margin_venue10 venueRasio 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_tiersmati / nyalaMaintenance margin naik seiring nilai nosional seperti tangga risk limit, jadi posisi besar kena likuidasi lebih cepat. Seluruh tangganya dipublikasikan di GET /v2/realism.
mmr_pct0.05 – 10Maintenance margin versimu sendiri, mengalahkan margin_venue dan default kami.

Apa yang tidak dimodelkan, kami sebutkan duluan daripada kamu temukan sendiri

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.

Biaya sesuai exchange yang benar-benar akan kamu pakai

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
VenueTakerDiskon referral kamiKamu bayar per sisi
Bybit0.055%20%0.044%
Binance0.050%20%0.040%
Bitget0.060%20%0.048%
Gate0.050%20%0.040%
Hyperliquid0.045%4% (kode MARGINPAD)0.0432%
OKX · Kraken0.050%-0.050%
MEXC0.020%-0.020%
KuCoin0.060%-0.060%
Default MarginPadbelum ada venue dipilih0.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.

Menulis bot yang tidak gampang rusak

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.

WebSocket - berhenti polling sepenuhnya

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.

Webhook - event dikirim ke server-mu API PRO

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 - satu strategi, satu hasil bersih 2.5

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.

Replay - jalankan bot-mu di satu hari yang sudah lewat 2.6

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.

Mengelola key-mu

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.

Bot arena - papan skor publik untuk bot

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.

Pakai dari Claude, ChatGPT, atau Cursor

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.

Format response - v1 dan v2

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

Kode error

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.

KodeHTTPYang harus dilakukan
missing_api_key / invalid_api_key401Kirim key yang valid di X-API-Key.
revoked_key401Buat key baru; key ini sudah dicabut.
rate_limit429Tunggu sampai Retry-After. Jangan langsung retry.
unknown_symbol404Cek /v1/markets.
symbol_required, margin_usd_min_1, margin_usd_max_100000, id_required400Perbaiki body request.
sl_wrong_side / tp_wrong_side400Response membawa live - taruh level-nya di sisi yang benar dari harga itu.
stop_wrong_side400Stop entry menunggu di sisi breakout (long di atas, short di bawah). Pakai type:"limit" untuk entry pullback.
trail_pct_invalid400trail_pct adalah persen antara 0.05 dan 50; nilai di luar itu ditolak, tidak pernah diam-diam dipangkas.
nothing_to_modify400/modify_order butuh minimal satu field.
plan_required402Webhook butuh paket berbayar. Semua yang lain di halaman ini ada di Free. Body-nya membawa plan_needed.
premium_required402Kode lama untuk plan_required, masih dikirim supaya bot 2.3 tetap mengenalinya.
too_many_webhooks409Hapus satu dulu - 15 hook di API Premium.
bad_url / bad_event400URL webhook harus https di host publik; nama event tercantum di GET /webhooks.
too_many_open409Posisi terbukamu sudah mencapai batas plan. Tutup salah satu.
already_closed400Aman saat retry - posisinya sudah diselesaikan.
no_price400Tidak ada harga live saat ini; posisi tetap terbuka. Coba lagi.
unavailable503Sementara. 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.

API data likuidasi gratis DATA LIVE

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.

GET/api/v1/feedLikuidasi terbaru di SEMUA simbol yang dilacak - {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.
GET/api/v1/liquidations/live?symbol=BTC&limit=400Event likuidasi terbaru mentah untuk satu simbol (BTC, ETH, SOL, XRP, DOGE, BNB, ADA, LINK, AVAX, LTC). side berisi long_liquidated atau short_liquidated, notional adalah ukuran dalam USD.
GET/api/v1/liquidations/recent?symbol=BTC&minutes=1440Histogram per rentang waktu (long vs short dalam $ per rentang) untuk chart - sumber yang persis sama dengan statistik heatmap kami. minutes: sampai 43200 (30 hari).
GET/api/v1/clusters?symbol=BTCKlaster likuidasi hasil model: level harga tempat likuiditas likuidasi diperkirakan berada saat ini - {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.

Backtest, paper, live - dengan urutan itu

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.

BacktestingPaper trading (API ini)Trading live
HargaCandle historisHarga live sungguhan, real-timeHarga live sungguhan
RisikoTidak adaTidak ada - dolar simulasiUang sungguhan dipertaruhkan
Menangkap bug logikaJarang - data replay menyembunyikannyaYa - jalur kode sama dengan liveBisa, tapi setiap bug memakan uang
Cek overfittingTidak - kamu menyetel di data iniYa - data masa depan yang belum pernah dilihatYa
BiayaGratisGratis dipakai - biaya & funding disimulasikanBiaya + rugi + funding
Cocok untukMenyaring ide dengan cepatMembuktikan bot sebelum mengisinya dengan danaStrategi 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.

Langkah tiga: di mana menjalankan bot sungguhan

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:

HLHyperliquidon-chain · API-first

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.

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

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 →
Link referral - MarginPad bisa mendapat komisi kalau kamu membuka akun, tanpa biaya tambahan untukmu; diskon Hyperliquid adalah diskon referral mereka. API paper tetap gratis apa pun pilihanmu, dan tidak ada yang di sini membutuhkan akun exchange. Hyperliquid tidak tersedia untuk warga AS sesuai ketentuannya.

FAQ

Apakah ada API data likuidasi / heatmap gratis?

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.

Apakah API bot trading ini benar-benar gratis?

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 pemrograman apa yang bisa kupakai?

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.

Koin apa saja yang bisa ditradingkan bot-ku?

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.

Perlu akun exchange atau deposit?

Tidak. Tanpa deposit, tanpa wallet, tanpa KYC. Kamu cukup masuk dengan email supaya API key dan posisimu tersimpan antar-sesi.

Apakah MarginPad Premium sudah termasuk API?

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.

Panduan dan tutorial