{"id":"io.github.Marginpad/sdk","slug":"io-github-marginpad-sdk","title":"MarginPad","description":"Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.","version":"3.0.2","publisher":{"kind":"github","id":"Marginpad","label":"@Marginpad on GitHub","url":"https://github.com/Marginpad"},"website":"https://marginpad.io/trading-api/#mcp","repository":"https://github.com/marginpad/sdk","remotes":[{"type":"streamable-http","url":"https://marginpad.io/mcp","headers":[{"description":"MarginPad Bot API key (mpb_...). Optional: without it the market-data tools work, the paper-trading tools need it.","isSecret":true,"name":"X-API-Key"}]}],"packages":[],"published":"2026-11-16","updated":"2026-11-16","status":"online","auth":"","latency_ms":1326,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_price","title":"Live price","description":"Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.","read_only":true},{"name":"get_klines","title":"OHLC candles","description":"OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.","read_only":true},{"name":"get_markets","title":"Tradable markets","description":"Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.","read_only":true},{"name":"get_screener","title":"Setup screener","description":"Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.","read_only":true},{"name":"get_funding","title":"Funding rates","description":"Current funding rates across exchanges - who pays whom to hold a perp position.","read_only":true},{"name":"get_open_interest","title":"Open interest","description":"Open interest per symbol - how much leveraged money is committed.","read_only":true},{"name":"get_catalysts","title":"Catalysts (news, listings, macro, hacks)","description":"Dated events that can move a coin, as they land: exchange listings and delistings, filings, macro prints, hacks (scored by the money lost), ETF and regulation headlines, official channels and fast news desks - one story per event with the desks that reported it, a 0-100 score, the coins named, the direction implied and how much events of that kind have measurably moved price.","read_only":true},{"name":"get_what_moved_it","title":"What moved it (30 days)","description":"Every abnormal jump or drop of the last 30 days for any market (coin, stock, index, forex, metal) with its causes and their shares, dated by the FIRST report of a story: the story that moved it (with desks and measured realism), a liquidation cascade or forced closes, the whale tracker, the tape, Bitcoin and why Bitcoin moved, US stocks, open interest (deleveraging, short covering, new positioning","read_only":true},{"name":"get_liquidations","title":"Liquidations (24h)","description":"Recent real liquidation events aggregated from twelve exchanges.","read_only":true},{"name":"get_fear_greed","title":"Fear and Greed index","description":"Crypto Fear and Greed index, current value and classification.","read_only":true},{"name":"get_economic_calendar","title":"Economic calendar","description":"Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.","read_only":true},{"name":"calc_liquidation","title":"Liquidation price calculator","description":"Liquidation price for a position: entry, leverage, side.","read_only":true},{"name":"calc_position_size","title":"Position size calculator","description":"Risk-based position size from account balance, risk percent, entry and stop.","read_only":true},{"name":"paper_balance","title":"Paper account balance","description":"Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.","read_only":true},{"name":"paper_positions","title":"Paper positions","description":"Your paper positions with live mark price and P&L net of fees; status \"open\" for just the open ones. Requires an API key.","read_only":true},{"name":"paper_trades","title":"Closed paper trades","description":"Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.","read_only":true},{"name":"paper_open","title":"Open a paper position","description":"Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.","read_only":false},{"name":"paper_close","title":"Close a paper position","description":"Close a simulated position, fully or partially. Requires an API key.","read_only":false},{"name":"paper_sltp","title":"Set stop / take-profit","description":"Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.","read_only":false},{"name":"paper_modify_order","title":"Modify a resting order","description":"Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.","read_only":false},{"name":"paper_fees","title":"Fee venue","description":"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 key, or \"marginpad\" for the default rate). Requires an API key.","read_only":false},{"name":"paper_sim","title":"Simulation profile","description":"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 right for learning and optimistic for proving out a bot. This sets any of it: the book size your res","read_only":false},{"name":"paper_realism","title":"Fill realism","description":"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 to build on a named venue’s published maintenance-margin rate (Binance 0.40%, Bybit 0.50%, MEXC 0.10%","read_only":false},{"name":"paper_report","title":"Trading report","description":"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.","read_only":true},{"name":"paper_accounts","title":"Paper books","description":"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.","read_only":true},{"name":"paper_reset","title":"Reset the paper book","description":"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.","read_only":false},{"name":"paper_equity","title":"Equity curve","description":"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.","read_only":true},{"name":"paper_replay","title":"Replay a past day","description":"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 the cursor, with stops, targets and liquidations checked on every candle. With no arguments it reads","read_only":false},{"name":"paper_limit_order","title":"Place a limit or stop order","description":"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. Requires an API key.","read_only":false},{"name":"paper_orders","title":"Resting orders","description":"Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.","read_only":true},{"name":"paper_cancel_order","title":"Cancel a resting order","description":"Cancel a resting limit order. Requires an API key.","read_only":false}],"server_info":{"name":"marginpad","title":"MarginPad","version":"2.4.0"},"category":"research","tags":["developer","ecommerce","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-08","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-marginpad-sdk/"}