# io.github.Marginpad/sdk

- Registry name: `io.github.Marginpad/sdk` · version 3.0.0
- Categories (automatic, keyword rules): Research & knowledge, Search & data, Markets & trading, Finance & markets
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.Marginpad%2Fsdk
- Server page: https://mcpstation.net/s/io.github.Marginpad--sdk.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://marginpad.io/mcp`

## Tools (as reported by the server, not verified)

- `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 eight 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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html