io.github.Marginpad/sdk · v3.0.0 · ecommerce
io.github.Marginpad/sdk is healthy: it completed an MCP handshake in 2707 ms and exposes 29 tools.
Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data.
Endpoint: https://marginpad.io/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 29 |
| Latency | 2707 ms |
| Last checked (UTC) | 2026-10-15T01:55:39.146Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-15T01:55:39.146Z | Healthy | 2707 |
get_price | Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed. |
get_klines | OHLC candles for a symbol. Use this to compute indicators or check a setup before trading. |
get_markets | Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade. |
get_screener | Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest. |
get_funding | Current funding rates across exchanges - who pays whom to hold a perp position. |
get_open_interest | Open interest per symbol - how much leveraged money is committed. |
get_liquidations | Recent real liquidation events aggregated from nine exchanges. |
get_fear_greed | Crypto Fear and Greed index, current value and classification. |
get_economic_calendar | Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory. |
calc_liquidation | Liquidation price for a position: entry, leverage, side. |
calc_position_size | Risk-based position size from account balance, risk percent, entry and stop. |
paper_balance | Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key. |
paper_positions | Your paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key. |
paper_trades | Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key. |
paper_open | Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key. |
paper_close | Close a simulated position, fully or partially. Requires an API key. |
paper_sltp | Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key. |
paper_modify_order | Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key. |
paper_fees | Which exchange fee schedule your paper fills are charged at: lists the venues we model (Bybit, Binance, OKX, Bitget, MEXC, Gate, KuCoin, Kraken, Hyperliquid) with their taker rate and the referral discount a MarginPad sign-up gets, and your current default. Pass set to change the default (a venue ke |
paper_sim | The whole paper-trading simulation, configurable. By default this engine is deliberately easy: a market order fills whole at the live price, maintenance margin is a flat 0.5%, the balance is a scorecard that never refuses an open, and there is no latency, no size impact and no partial fill. That is |
paper_realism | How honestly your paper fills are simulated. By default a market order fills at the live price with no slippage and maintenance margin is a flat 0.5%, which is easier than a real exchange and increasingly so as a position grows. Pass slippage and/or margin_tiers to turn either on, and margin_venue t |
paper_report | The 30-day trading report for this account, measured from its own closed trades: totals and a skill score (free), win rate and return by coin, leverage band, side, hour and day plus written findings (API Pro and above). Requires an API key. |
paper_accounts | Every book (sub-account) of this account with lifetime numbers and the keys bound to it. A book is a separate journal, balance and report; a key minted with a book name trades that book. Requires an API key. |
paper_reset | Restart this key’s book at $10,000: closed trades are archived (never deleted), resting orders cancelled, the report and equity curve start from now. Refused while positions are open - close them first. Requires an API key. |
paper_equity | The equity curve of this key’s book: starting balance + realized P&L per bucket from the ledger, the live unrealized point at the end, and max drawdown. Requires an API key. |
paper_replay | Backtest with the real routes: replay one past UTC day on MarginPad’s 1-minute candles. With symbol+day it STARTS a replay (speed = market seconds per real second, 1-600, default 60): from then on paper_open / paper_positions / paper_close act on a separate replay journal priced at the candle under |
paper_limit_order | Place a resting order that fills only when the market reaches your price, and fills AT that price. type "limit" = a pullback entry (long below the market, short above); type "stop" = a breakout entry (long above the market, short below). To open right now use paper_open instead. Simulated money only |
paper_orders | Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key. |
paper_cancel_order | Cancel a resting limit order. Requires an API key. |