io.github.Marginpad/sdk is an MCP server published by io.github.Marginpad, hosted at marginpad.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 31 tools, including get_price, get_klines, get_markets, get_screener, get_funding.
Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Symbol without the USDT suffix, e.g. BTC, ETH, AAPL, EURUSD, XAU |
{
"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.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Symbol without the USDT suffix, e.g. BTC, ETH, AAPL, EURUSD, XAU"
}
}
},
"annotations": {
"title": "Live price",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | |
| interval | string | Minutes: 1, 5, 15, 60, 240, 1440, 10080 |
{
"name": "get_klines",
"title": "OHLC candles",
"description": "OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string"
},
"interval": {
"type": "string",
"default": "60",
"description": "Minutes: 1, 5, 15, 60, 240, 1440, 10080"
}
}
},
"annotations": {
"title": "OHLC candles",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
| Parameter | Type | Description |
|---|---|---|
| asset_class | string | one of ["crypto","stock","forex","metal","index"] |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"asset_class": {
"enum": [
"crypto",
"stock",
"forex",
"metal",
"index"
],
"type": "string"
}
}
},
"annotations": {
"title": "Tradable markets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
No parameters.
{
"name": "get_screener",
"title": "Setup screener",
"description": "Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Setup screener",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Current funding rates across exchanges - who pays whom to hold a perp position.
| Parameter | Type | Description |
|---|---|---|
| symbol | string |
{
"name": "get_funding",
"title": "Funding rates",
"description": "Current funding rates across exchanges - who pays whom to hold a perp position.",
"inputSchema": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
}
}
},
"annotations": {
"title": "Funding rates",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Open interest per symbol - how much leveraged money is committed.
| Parameter | Type | Description |
|---|---|---|
| symbol | string |
{
"name": "get_open_interest",
"title": "Open interest",
"description": "Open interest per symbol - how much leveraged money is committed.",
"inputSchema": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
}
}
},
"annotations": {
"title": "Open interest",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind | string | listing, delisting, macro, hack, etf, regulation, politics, whale, unlock, protocol, adoption, filing, news |
| limit | number | |
| symbol | string | Only items naming this coin |
| min_score | number | Minimum score 0-100 (default 25) |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "listing, delisting, macro, hack, etf, regulation, politics, whale, unlock, protocol, adoption, filing, news"
},
"limit": {
"type": "number"
},
"symbol": {
"type": "string",
"description": "Only items naming this coin"
},
"min_score": {
"type": "number",
"description": "Minimum score 0-100 (default 25)"
}
}
},
"annotations": {
"title": "Catalysts (news, listings, macro, hacks)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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), the chart structure (a broken level, a new 30-day extreme), with a sentence on every move - unknown said out loud. Pass at (ms) with pct for a live verdict on a move happening now.
| Parameter | Type | Description |
|---|---|---|
| n | number | |
| at | number | Live verdict: the move start in ms |
| tf | number | Candle minutes: 5, 15 or 60 |
| pct | number | |
| days | number | |
| symbol | string |
{
"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), the chart structure (a broken level, a new 30-day extreme), with a sentence on every move - unknown said out loud. Pass at (ms) with pct for a live verdict on a move happening now.",
"inputSchema": {
"type": "object",
"properties": {
"n": {
"type": "number"
},
"at": {
"type": "number",
"description": "Live verdict: the move start in ms"
},
"tf": {
"type": "number",
"description": "Candle minutes: 5, 15 or 60"
},
"pct": {
"type": "number"
},
"days": {
"type": "number"
},
"symbol": {
"type": "string"
}
}
},
"annotations": {
"title": "What moved it (30 days)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Recent real liquidation events aggregated from twelve exchanges.
| Parameter | Type | Description |
|---|---|---|
| symbol | string |
{
"name": "get_liquidations",
"title": "Liquidations (24h)",
"description": "Recent real liquidation events aggregated from twelve exchanges.",
"inputSchema": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
}
}
},
"annotations": {
"title": "Liquidations (24h)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Crypto Fear and Greed index, current value and classification.
No parameters.
{
"name": "get_fear_greed",
"title": "Fear and Greed index",
"description": "Crypto Fear and Greed index, current value and classification.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Fear and Greed index",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
No parameters.
{
"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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Economic calendar",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Liquidation price for a position: entry, leverage, side.
| Parameter | Type | Description |
|---|---|---|
| side * | string | one of ["long","short"] |
| entry * | number | |
| leverage * | number |
{
"name": "calc_liquidation",
"title": "Liquidation price calculator",
"description": "Liquidation price for a position: entry, leverage, side.",
"inputSchema": {
"type": "object",
"required": [
"entry",
"leverage",
"side"
],
"properties": {
"side": {
"enum": [
"long",
"short"
],
"type": "string"
},
"entry": {
"type": "number"
},
"leverage": {
"type": "number"
}
}
},
"annotations": {
"title": "Liquidation price calculator",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Risk-based position size from account balance, risk percent, entry and stop.
| Parameter | Type | Description |
|---|---|---|
| stop * | number | |
| entry * | number | |
| balance * | number | |
| risk_pct * | number |
{
"name": "calc_position_size",
"title": "Position size calculator",
"description": "Risk-based position size from account balance, risk percent, entry and stop.",
"inputSchema": {
"type": "object",
"required": [
"balance",
"risk_pct",
"entry",
"stop"
],
"properties": {
"stop": {
"type": "number"
},
"entry": {
"type": "number"
},
"balance": {
"type": "number"
},
"risk_pct": {
"type": "number"
}
}
},
"annotations": {
"title": "Position size calculator",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
No parameters.
{
"name": "paper_balance",
"title": "Paper account balance",
"description": "Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Paper account balance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| status | string | Omit for both |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"status": {
"enum": [
"open",
"closed"
],
"type": "string",
"description": "Omit for both"
}
}
},
"annotations": {
"title": "Paper positions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| before | number | Epoch ms cursor from next_before |
{
"name": "paper_trades",
"title": "Closed paper trades",
"description": "Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 100
},
"before": {
"type": "number",
"description": "Epoch ms cursor from next_before"
}
}
},
"annotations": {
"title": "Closed paper trades",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| sl | ["number","null"] | |
| tp | ["number","null"] | |
| side * | string | one of ["long","short"] |
| symbol * | string | |
| dry_run | boolean | true = validate and price the trade (entry, liquidation, quantity, fees) and write NOTHING |
| leverage * | number | 1 to the symbol cap from get_markets |
| trail_pct | ["number","null"] | Trailing stop distance in percent (0.05-50): the stop follows the best price seen, server-side, even while the bot is offline |
| margin_usd * | number | 1 to 100000 |
| client_order_id | string | Your own id - retrying with the same one returns the first position instead of opening a second |
Close a simulated position, fully or partially. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| pct | number | Percent to close, 1-100. Omit for the whole position. |
{
"name": "paper_close",
"title": "Close a paper position",
"description": "Close a simulated position, fully or partially. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"pct": {
"type": "number",
"description": "Percent to close, 1-100. Omit for the whole position."
}
}
},
"annotations": {
"title": "Close a paper position",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| sl | ["number","null"] | |
| tp | ["number","null"] | |
| trail_pct | ["number","null"] | Trailing stop distance in percent (0.05-50); null switches trailing off |
{
"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.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"sl": {
"type": [
"number",
"null"
]
},
"tp": {
"type": [
"number",
"null"
]
},
"trail_pct": {
"type": [
"number",
"null"
],
"description": "Trailing stop distance in percent (0.05-50); null switches trailing off"
}
}
},
"annotations": {
"title": "Set stop / take-profit",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| sl | ["number","null"] | |
| tp | ["number","null"] | |
| leverage | number | |
| order_id * | string | |
| trail_pct | ["number","null"] | |
| margin_usd | number | |
| limit_price | number |
{
"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.",
"inputSchema": {
"type": "object",
"required": [
"order_id"
],
"properties": {
"sl": {
"type": [
"number",
"null"
]
},
"tp": {
"type": [
"number",
"null"
]
},
"leverage": {
"type": "number"
},
"order_id": {
"type": "string"
},
"trail_pct": {
"type": [
"number",
"null"
]
},
"margin_usd": {
"type": "number"
},
"limit_price": {
"type": "number"
}
}
},
"annotations": {
"title": "Modify a resting order",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| set | string | Omit to read. A venue key from the list, or "marginpad" to reset. |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"set": {
"type": "string",
"description": "Omit to read. A venue key from the list, or \"marginpad\" to reset."
}
}
},
"annotations": {
"title": "Fee venue",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 results are measured against and whether it is a real budget (margin_enforced), what crossing the book costs on entry and exit (slippage, slippage_bps, impact_bps_per_100k), how long your order is in flight (latency_ms), whether orders fill part-way (partial_fills, min_fill_pct), how often the venue refuses (reject_rate_pct), your own fee (taker_bps), funding (funding, funding_mult) and where liquidation sits (margin_venue, margin_tiers, mmr_pct). Easiest route: pass a preset - frictionless, realistic, binance, bybit, okx, hyperliquid, thin_book or brutal. Reading returns every field with its range, its default and what it changes, the presets, and what a fill would look like right now. Out-of-range values are refused, never clamped. Positions keep the simulation they were filled under. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| reset | boolean | true = back to the engine defaults. |
| preset | string | frictionless | realistic | binance | bybit | okx | hyperliquid | thin_book | brutal. A preset starts from the defaults, so it is a clean slate plus that configuration. Omit every field to READ. |
| funding | boolean | false = never charge funding, which is how you separate an execution edge from a carry edge. |
| mmr_pct | number | 0.05-10. Your own maintenance margin, beating margin_venue. |
| slippage | boolean | Fill against yourself the way a real book does: 0.01% crypto majors, 0.05% other crypto, 0.005% forex, 0.02% stocks/metals/indices. |
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%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%). Reading returns your setting, every venue rate and the whole size-tier ladder, so a liquidation price never has to be reverse-engineered. Positions keep the margin they were filled with. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| slippage | boolean | Fill against yourself the way a real order book does: 0.01% crypto majors, 0.05% other crypto, 0.005% forex, 0.02% stocks/metals/indices. |
| margin_tiers | boolean | Raise maintenance margin with position size, as an exchange risk-limit table does, so a large position is liquidated sooner. |
| margin_venue | string | binance | bybit | okx | bitget | mexc | kucoin | gate | kraken | hyperliquid | coinbase, or "marginpad" to reset. Omit every field to read. |
{
"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%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%). Reading returns your setting, every venue rate and the whole size-tier ladder, so a liquidation price never has to be reverse-engineered. Positions keep the margin they were filled with. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"slippage": {
"type": "boolean",
"description": "Fill against yourself the way a real order book does: 0.01% crypto majors, 0.05% other crypto, 0.005% forex, 0.02% stocks/metals/indices."
},
"margin_tiers": {
"type": "boolean",
"description": "Raise maintenance margin with position size, as an exchange risk-limit table does, so a large position is liquidated sooner."
},
"margin_venue": {
"type": "string",
"description": "binance | bybit | okx | bitget | mexc | kucoin | gate | kraken | hyperliquid | coinbase, or \"marginpad\" to reset. Omit every field to read."
}
}
},
"annotations": {
"title": "Fill realism",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | number | 1-30, default 30 |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "1-30, default 30"
}
}
},
"annotations": {
"title": "Trading report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Paper books",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Reset the paper book",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | number | 1-90, default 30 |
| step_min | number | Bucket minutes, 5-1440 |
{
"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.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "1-90, default 30"
},
"step_min": {
"type": "number",
"description": "Bucket minutes, 5-1440"
}
}
},
"annotations": {
"title": "Equity curve",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 the status (cursor, price, progress, candles up to the cursor). With act "stop" it closes everything at the cursor and returns the summary. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| act | string | "stop" ends the replay and returns the summary |
| day | string | Start: a complete past UTC day, YYYY-MM-DD |
| speed | number | Start: 1-600, default 60 |
| symbol | string | Start: the market, e.g. BTC |
{
"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 the status (cursor, price, progress, candles up to the cursor). With act \"stop\" it closes everything at the cursor and returns the summary. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"act": {
"enum": [
"stop"
],
"type": "string",
"description": "\"stop\" ends the replay and returns the summary"
},
"day": {
"type": "string",
"description": "Start: a complete past UTC day, YYYY-MM-DD"
},
"speed": {
"type": "number",
"description": "Start: 1-600, default 60"
},
"symbol": {
"type": "string",
"description": "Start: the market, e.g. BTC"
}
}
},
"annotations": {
"title": "Replay a past day",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sl | ["number","null"] | |
| tp | ["number","null"] | |
| side * | string | one of ["long","short"] |
| symbol * | string | |
| leverage * | number | |
| margin_usd * | number | 1 to 100000 |
| limit_price * | number | Below the market for a long, above it for a short |
| client_order_id | string |
{
"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.",
"inputSchema": {
"type": "object",
"required": [
"symbol",
"side",
"limit_price",
"margin_usd",
"leverage"
],
"properties": {
"sl": {
"type": [
"number",
"null"
]
},
"tp": {
"type": [
"number",
"null"
]
},
"side": {
"enum": [
"long",
"short"
],
"type": "string"
},
"symbol": {
"type": "string"
},
"leverage": {
"type": "number"
},
"margin_usd": {
"type": "number",
"description": "1 to 100000"
},
"limit_price": {
"type": "number",
"description": "Below the market for a long, above it for a short"
},
"client_order_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Place a limit or stop order",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
No parameters.
{
"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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Resting orders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Cancel a resting limit order. Requires an API key.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string |
{
"name": "paper_cancel_order",
"title": "Cancel a resting order",
"description": "Cancel a resting limit order. Requires an API key.",
"inputSchema": {
"type": "object",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Cancel a resting order",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Free crypto market data and a paper-trading account. Market-data tools need no key. Paper-trading tools trade SIMULATED money on a MarginPad account and need a free API key sent as the X-API-Key header (get one at https://marginpad.io/trading-api/). Fees and funding are simulated realistically, so P&L here reflects what the same strategy would cost on a real exchange. Call get_markets before sizing a trade - leverage caps and fees differ per asset class.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"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.",
"inputSchema": {
"type": "object",
"required": [
"symbol",
"side",
"margin_usd",
"leverage"
],
"properties": {
"sl": {
"type": [
"number",
"null"
]
},
"tp": {
"type": [
"number",
"null"
]
},
"side": {
"enum": [
"long",
"short"
],
"type": "string"
},
"symbol": {
"type": "string"
},
"dry_run": {
"type": "boolean",
"description": "true = validate and price the trade (entry, liquidation, quantity, fees) and write NOTHING"
},
"leverage": {
"type": "number",
"description": "1 to the symbol cap from get_markets"
},
"trail_pct": {
"type": [
"number",
"null"
],
"description": "Trailing stop distance in percent (0.05-50): the stop follows the best price seen, server-side, even while the bot is offline"
},
"margin_usd": {
"type": "number",
"description": "1 to 100000"
},
"client_order_id": {
"type": "string",
"description": "Your own id - retrying with the same one returns the first position instead of opening a second"
}
}
},
"annotations": {
"title": "Open a paper position",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| taker_bps | number | 0-100. Your own per-side fee in basis points. 5.5 = 0.055%. |
| latency_ms | number | 0-2000. Your order is in flight this long and the price is re-read afterwards. |
| funding_mult | number | 0-5. Scale the real 8-hourly funding rate. |
| leverage_max | number | Your own leverage ceiling below the market cap. 0 = the market cap. |
| margin_tiers | boolean | Raise maintenance margin with size, as a risk-limit ladder does, so a large position liquidates sooner. |
| margin_venue | string | binance | bybit | okx | bitget | mexc | kucoin | gate | kraken | hyperliquid | coinbase, or "marginpad". Moves ONLY where liquidation sits. |
| min_fill_pct | number | 10-100. The worst fill ratio with partial_fills on. |
| slippage_bps | number | 0-500. Your own crossing cost in basis points instead of that table. 10 = 0.10%. |
| exit_slippage | boolean | Pay the crossing cost on the way out too (default true). A stop, take-profit or liquidation still fills at its level. |
| partial_fills | boolean | Allow a market order to fill less than it asked for. |
| margin_enforced | boolean | true = an open needing more than free margin is refused 402, as a venue refuses it. Free margin is balance minus committed margin; unrealized profit is not collateral, because every position is isolated. |
| reject_rate_pct | number | 0-50. Share of opens refused 503 venue_rejected on purpose. |
| max_notional_usd | number | Your own ceiling on one position’s notional. 0 = none. |
| start_balance_usd | number | 100 to 10,000,000. The book return_pct, the equity curve and max drawdown are measured against. |
| impact_bps_per_100k | number | 0-500. Extra basis points per $100,000 of notional, because size walks further down the book. |
{
"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 results are measured against and whether it is a real budget (margin_enforced), what crossing the book costs on entry and exit (slippage, slippage_bps, impact_bps_per_100k), how long your order is in flight (latency_ms), whether orders fill part-way (partial_fills, min_fill_pct), how often the venue refuses (reject_rate_pct), your own fee (taker_bps), funding (funding, funding_mult) and where liquidation sits (margin_venue, margin_tiers, mmr_pct). Easiest route: pass a preset - frictionless, realistic, binance, bybit, okx, hyperliquid, thin_book or brutal. Reading returns every field with its range, its default and what it changes, the presets, and what a fill would look like right now. Out-of-range values are refused, never clamped. Positions keep the simulation they were filled under. Requires an API key.",
"inputSchema": {
"type": "object",
"properties": {
"reset": {
"type": "boolean",
"description": "true = back to the engine defaults."
},
"preset": {
"type": "string",
"description": "frictionless | realistic | binance | bybit | okx | hyperliquid | thin_book | brutal. A preset starts from the defaults, so it is a clean slate plus that configuration. Omit every field to READ."
},
"funding": {
"type": "boolean",
"description": "false = never charge funding, which is how you separate an execution edge from a carry edge."
},
"mmr_pct": {
"type": "number",
"description": "0.05-10. Your own maintenance margin, beating margin_venue."
},
"slippage": {
"type": "boolean",
"description": "Fill against yourself the way a real book does: 0.01% crypto majors, 0.05% other crypto, 0.005% forex, 0.02% stocks/metals/indices."
},
"taker_bps": {
"type": "number",
"description": "0-100. Your own per-side fee in basis points. 5.5 = 0.055%."
},
"latency_ms": {
"type": "number",
"description": "0-2000. Your order is in flight this long and the price is re-read afterwards."
},
"funding_mult": {
"type": "number",
"description": "0-5. Scale the real 8-hourly funding rate."
},
"leverage_max": {
"type": "number",
"description": "Your own leverage ceiling below the market cap. 0 = the market cap."
},
"margin_tiers": {
"type": "boolean",
"description": "Raise maintenance margin with size, as a risk-limit ladder does, so a large position liquidates sooner."
},
"margin_venue": {
"type": "string",
"description": "binance | bybit | okx | bitget | mexc | kucoin | gate | kraken | hyperliquid | coinbase, or \"marginpad\". Moves ONLY where liquidation sits."
},
"min_fill_pct": {
"type": "number",
"description": "10-100. The worst fill ratio with partial_fills on."
},
"slippage_bps": {
"type": "number",
"description": "0-500. Your own crossing cost in basis points instead of that table. 10 = 0.10%."
},
"exit_slippage": {
"type": "boolean",
"description": "Pay the crossing cost on the way out too (default true). A stop, take-profit or liquidation still fills at its level."
},
"partial_fills": {
"type": "boolean",
"description": "Allow a market order to fill less than it asked for."
},
"margin_enforced": {
"type": "boolean",
"description": "true = an open needing more than free margin is refused 402, as a venue refuses it. Free margin is balance minus committed margin; unrealized profit is not collateral, because every position is isolated."
},
"reject_rate_pct": {
"type": "number",
"description": "0-50. Share of opens refused 503 venue_rejected on purpose."
},
"max_notional_usd": {
"type": "number",
"description": "Your own ceiling on one position’s notional. 0 = none."
},
"start_balance_usd": {
"type": "number",
"description": "100 to 10,000,000. The book return_pct, the equity curve and max drawdown are measured against."
},
"impact_bps_per_100k": {
"type": "number",
"description": "0-500. Extra basis points per $100,000 of notional, because size walks further down the book."
}
}
},
"annotations": {
"title": "Simulation profile",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}