MarginPad

MarginPad SDK

ボット向けの無料暗号資産先物ペーパートレードと無料の市場データを提供します。キーは1つ、KYC不要、入金不要です。 リアルタイム価格、実際の手数料体系、ファンディング、清算、指値注文とストップ注文、トレーリングストップ、Webhook、WebSocketストリームを使って、戦略やAIエージェントをテストできます。その後、同じコードを実際の取引所で使用できます。

• ガイド：https://marginpad.io/trading-api/
• リファレンス（OpenAPI、ライブで試用可能）：https://marginpad.io/api-docs/
• ステータス：https://marginpad.io/status/ - 変更履歴：https://marginpad.io/api/changelog.xml
• Claude、ChatGPT、Cursor 向け MCP サーバー：https://marginpad.io/trading-api/#mcp

データの由来

これらのクライアントが読み取る市場データは、MarginPad が独自に計測し、キーなしで無料公開しているページおよび JSON データです。

• 独自の収集システムによる9取引所の清算データ：https://marginpad.io/liquidations/ · ライブフィード https://marginpad.io/rekt/ · https://marginpad.io/btc-liquidation-map/ などの通貨別マップ · ライブヒートマップ https://marginpad.io/heatmap
• オンチェーンデータを読み取った、正確な清算価格付きの Hyperliquid の大口ポジション：https://marginpad.io/hyperliquid-whales/
• ファンディング、未決済建玉、ロング／ショート：https://marginpad.io/funding/ · https://marginpad.io/open-interest/ · https://marginpad.io/long-short/
• 1つの質問に、1つの計測された回答を提供します：https://marginpad.io/how-many-traders-liquidated-today/ · https://marginpad.io/biggest-liquidation-today/ · https://marginpad.io/what-leverage-should-a-beginner-use/ · https://marginpad.io/where-can-i-test-a-trading-bot/
• この API のエンジンも稼働する練習用ターミナル：https://marginpad.io/paper-trade（登録不要）、およびシーズン制のコンペティション：https://marginpad.io/trading-competition/

インストール

pip install marginpad            # Python 3.8+, no dependencies (pip install "marginpad[stream]" for the WebSocket)
npm install marginpad            # Node 18+, zero dependencies

Python

from marginpad import MarginPad

mp = MarginPad("mpb_...")                                   # key from https://marginpad.io/trading-api/
print(mp.price("BTC"))                                      # keyless market data
pos = mp.open("BTC", "long", margin_usd=100, leverage=10, sl=58000, tp=66000,
              client_order_id="sig-2026-09-12-1403")        # idempotent: a retry returns the same position
mp.sltp(pos["id"], trail_pct=1.5)                           # trailing stop, ratcheted server-side
print(mp.account())

JavaScript

const { MarginPad } = require('marginpad');
const mp = new MarginPad('mpb_...');
const { position } = await mp.open({ symbol: 'BTC', side: 'long', margin_usd: 100, leverage: 10, client_order_id: 'sig-1' });
mp.stream(ev => console.log(ev.type, ev.data));             // positions pushed on change, prices each tick

台帳、リセット、エクイティ、リプレイ（2.5 / 2.6）

mp.accounts()                                   # every book of the account with lifetime numbers
mp.reset()                                      # this key's book back to $10,000 (archived, never deleted)
mp.equity(days=30, step_min=60)                 # equity curve + max drawdown
mp.replay_start("BTC", "2026-09-11", speed=120) # run the same code through a past day, 12 minutes per day
mp.replay(interval=5, bars=120)                 # cursor, price, candles up to the cursor
mp.replay_stop()                                # summary: closes, win rate, P&L, return, liquidations

book（POST /api/bot/key で {"act":"create","name":"rsi","book":"rsi"}）を指定して発行したキーは、独立した台帳で取引します。1つの戦略に1つのキーを使うことで、結果を明確に分けられます。リプレイ中、そのキーによるすべての取引呼び出しは、カーソル位置のローソク足を基準価格とするリプレイ用台帳に対して実行されます。2回の呼び出しの間にある各ローソク足で、ストップ、ターゲット、清算が確認されます。

シミュレーションは自由に設定できます

18個のフィールドと8種類のプリセットを使って、実際に取引する環境に合わせてペーパー取引の場を設定できます。デフォルト設定は意図的に摩擦のないものになっており、変更するまでは、すでに構築したものに影響しません。

mp.sim()                                   # your profile, every field with its range, the presets
mp.sim(preset="realistic")                 # the honest middle, in one call
mp.sim(preset="bybit")                     # Bybit's published taker fee and maintenance margin
mp.sim(preset="brutal")                    # refusals, partial fills, a second of latency
mp.sim(start_balance_usd=2500, margin_enforced=True, slippage_bps=8, latency_ms=250)
mp.sim(reset=True)                         # back to the defaults

await mp.sim({ preset: 'realistic' });
await mp.sim({ start_balance_usd: 2500, margin_enforced: true, reject_rate_pct: 2 });

台帳（start_balance_usd、margin_enforced、leverage_max、max_notional_usd）、約定（slippage、slippage_bps、impact_bps_per_100k、exit_slippage、latency_ms、partial_fills、min_fill_pct、reject_rate_pct）、コスト（taker_bps、funding、funding_mult）、および清算（margin_venue、margin_tiers、mmr_pct）を設定できます。

範囲外の値は拒否され、上限や下限に丸められることはありません。また、ポジションは建てられた時点のシミュレーション設定を、そのポジションが存続する間ずっと維持します。margin_enforced を有効にすると、残高が実際の予算として扱われます。予算を超えるサイズを指定すると、オープン処理は 402 を返します。これは実際のボットが処理しなければならない失敗であり、摩擦のないシミュレーターでは決して発生しません。再試行ループを書く価値があるのは reject_rate_pct です。

各フィールドの範囲：https://marginpad.io/trading-api/#sim

例

• examples/agent_loop.py：ポーリングの集中を避けながら、1分ごとにポジションを建て、管理し、決済するシグナルループです。
• examples/webhook_server.js：署名検証を行いながら、position.closed / order.filled イベントを受信します。
• examples/mcp.md：MCP サーバーを通じて、Claude Desktop または Cursor からペーパーアカウントで取引できるようにします。

制限

プラン	リクエスト／分	キー	オープンポジション	ブック	Webhook
Free $0	120	3	50	1	-
Pro $27	600	10	200	5	3
Max $69	2000	30	500	20	15
Business $139	5000	100	1000	50	50

API プランは独立した製品です。MarginPad Premium に登録しても API プランは含まれず、API プランを購入してもサイト上の機能は含まれません。すべてのマーケットデータエンドポイントは無料で、API キーもアカウントもトライアルも不要です。ペーパートレードエンジン、シミュレーション、ブック、リプレイ、WebSocket ストリームは、最初のキーを発行した日から 7 日間無料で利用できます（2026-10-13 以降）。その後は有料プランが必要です。有料プラン内でティアによる利用制限があるのは、Webhook と AI 読み取りのみです。取引履歴の保存期間は、トライアルでは 30 日間、有料プランでは 90 日間です。

本番環境での測定では、最もリクエストの多いボットでも 1 分あたり 66 件で、Free の上限である 120 件を下回っています。いずれのプランでもレート制限を受けたキーはありません。スループットではなく、キー数と履歴の保存期間を基準に選んでください。

すべてのレスポンスには X-RateLimit-Limit / Remaining / Reset が含まれます。429 を受け取った場合、両方のクライアントは Retry-After の時間だけ待ってから、1 回だけ再試行します。範囲外の入力は、名前付きエラー（leverage_max にはその市場の上限が含まれます）で拒否され、暗黙に上限値へ丸められることはありません。

誠実さについて

これはシミュレーターです。手数料、ファンディング、清算の計算は実際の取引所を反映しており、上記の約定条件はすべてご自身で設定できます。ただし、impact_bps_per_100k の背後に注文板はないため、市場インパクトは板の厚さに基づいて測定するのではなく、モデル化されています。また、ストップ、利確目標、清算は、それぞれ設定された価格で約定し、価格をまたぐ際のコストは発生しません。ここでうまく動作するボットでも、実際に運用する前に少額でテストする必要があります。教育目的での利用を想定しており、投資助言ではありません。

MIT ライセンスです。