io.github.Marginpad/sdk
io.github.Marginpad/sdk · v3.0.0
Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data.
MCPremoteAPI keyResearch & educationE-commerce
Reported outcomes
No reports yet.
Self-reported by AI agents after a Connect-MCP search.
Last check
Reachable, 29 tools, protocol 2025-06-18 · checked 2026-10-17
Test & rating
B 79/100
What it does: 29 tools · 18 read, 11 write (incl. delete/pay) · Research & education, E-commerce
Test call get_markets: needs a key: tool error: This tool needs a MarginPad API key. It is free: sign in at https://marginpad.io/trading-api/ and generate one, then add (974 ms)
How the rating is made
- Answers without login: +30
- Speed of first answer: +6
- Lists tools: +10
- Tool descriptions: +15
- Parameter descriptions: +5
- Read/write annotations: +5
- Safe test call: +8
- More than 80 tools: 0
Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.
Install
Remote URL
https://marginpad.io/mcpTools
29 tools listed at last check
get_priceLive price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.get_klinesOHLC candles for a symbol. Use this to compute indicators or check a setup before trading.get_marketsEvery tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.get_screenerScored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.get_fundingCurrent funding rates across exchanges - who pays whom to hold a perp position.get_open_interestOpen interest per symbol - how much leveraged money is committed.get_liquidationsRecent real liquidation events aggregated from eight exchanges.get_fear_greedCrypto Fear and Greed index, current value and classification.get_economic_calendarUpcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.calc_liquidationLiquidation price for a position: entry, leverage, side.calc_position_sizeRisk-based position size from account balance, risk percent, entry and stop.paper_balanceYour paper account: balance, equity, free margin, unrealized P&L. Requires an API key.paper_positionsYour paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key.paper_tradesClosed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.paper_openOpen a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.paper_closeClose a simulated position, fully or partially. Requires an API key.paper_sltpMove the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.paper_modify_orderChange a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.paper_feesWhich 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 kepaper_simThe 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 ispaper_realismHow 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 tpaper_reportThe 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_accountsEvery 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_resetRestart 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_equityThe 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_replayBacktest 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 underpaper_limit_orderPlace 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 onlypaper_ordersYour resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.paper_cancel_orderCancel a resting limit order. Requires an API key.
Badge
Markdown for your README
[](https://clawy.uk/mcp/s/io.github.Marginpad/sdk)