io.github.Marginpad/sdk

Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data.

Endpointhttps://marginpad.io/mcp (streamable-http)
Registry version3.0.1
Now29 tools · grade C (71) · pin ts_eb24aec01e00832bcf45ae7b803f785c · protocol 2025-06-18
First / last listed2026-10-29 01:29 UTC / 2026-10-29 01:29 UTC
Grade over time2026-10-29: C (71), 29 tools

Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.

Timeline

First listing · 2026-10-29 01:29 UTC
29 tools, grade C (71)

Tools: get_price get_klines get_markets get_screener get_funding get_open_interest get_liquidations get_fear_greed get_economic_calendar calc_liquidation calc_position_size paper_balance paper_positions paper_trades paper_open paper_close paper_sltp paper_modify_order paper_fees paper_sim paper_realism paper_report paper_accounts paper_reset paper_equity paper_replay paper_limit_order paper_orders paper_cancel_order

Current tools (29)

get_priceLive price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
params: symbol*
get_klinesOHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
params: symbol*, interval
get_marketsEvery tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
params: asset_class
get_screenerScored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
params: none
get_fundingCurrent funding rates across exchanges - who pays whom to hold a perp position.
params: symbol
get_open_interestOpen interest per symbol - how much leveraged money is committed.
params: symbol
get_liquidationsRecent real liquidation events aggregated from eight exchanges.
params: symbol
get_fear_greedCrypto Fear and Greed index, current value and classification.
params: none
get_economic_calendarUpcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
params: none
calc_liquidationLiquidation price for a position: entry, leverage, side.
params: entry*, leverage*, side*
calc_position_sizeRisk-based position size from account balance, risk percent, entry and stop.
params: balance*, risk_pct*, entry*, stop*
paper_balanceYour paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
params: none
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.
params: status
paper_tradesClosed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.
params: limit, before
paper_openOpen a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
params: symbol*, side*, margin_usd*, leverage*, sl, tp, trail_pct, dry_run, client_order_id
paper_closeClose a simulated position, fully or partially. Requires an API key.
params: id*, pct
paper_sltpMove the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
params: id*, sl, tp, trail_pct
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.
params: order_id*, limit_price, sl, tp, margin_usd, leverage, trail_pct
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 key, or "marginpad" for the default rate). Requires an API key.
params: set
paper_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 is right for learning and optimistic for proving out a bot. This sets any of it: the book size your res
params: preset, reset, 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
paper_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 to build on a named venue’s published maintenance-margin rate (Binance 0.40%, Bybit 0.50%, MEXC 0.10%
params: slippage, margin_tiers, margin_venue
paper_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.
params: days
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.
params: none
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.
params: none
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.
params: days, step_min
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 under the cursor, with stops, targets and liquidations checked on every candle. With no arguments it reads
params: symbol, day, speed, act
paper_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 only. Requires an API key.
params: symbol*, side*, limit_price*, margin_usd*, leverage*, sl, tp, client_order_id
paper_ordersYour resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
params: none
paper_cancel_orderCancel a resting limit order. Requires an API key.
params: order_id*

Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.