Skip to content
Agentmart
Submit a tool

SDK

Free crypto-futures paper trading and live market data for AI agents.

Connector by Marginpad · GitHub account verified by the MCP Registry

IndexedMITRemote (HTTP)
Write a review

Chalk Labs

Need help deploying SDK?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/marginpad-sdk

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://marginpad.io/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
18 read · 8 write · 3 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 29

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 18 · Look things up without changing anything.

  • calc_liquidation
  • calc_position_size
  • get_economic_calendar
  • get_fear_greed
  • get_funding
  • get_klines
  • get_liquidations
  • get_markets
  • get_open_interest
  • get_price
  • get_screener
  • paper_accounts
Show 6 more tools
  • paper_balance
  • paper_equity
  • paper_orders
  • paper_positions
  • paper_report
  • paper_trades

Write 8 · Create, change, send or run things.

  • paper_fees
  • paper_limit_order
  • paper_modify_order
  • paper_open
  • paper_realism
  • paper_replay
  • paper_sim
  • paper_sltp

Delete 3 · Delete, drop, revoke or wipe things.

  • paper_cancel_order
  • paper_close
  • paper_reset

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • X-API-Key

Network hosts it talks to 1

  • marginpad.io · found in remote endpoint, install command

Tools (29)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • calc_liquidationLiquidation price calculatorread-only

    Liquidation price for a position: entry, leverage, side.

  • calc_position_sizePosition size calculatorread-only

    Risk-based position size from account balance, risk percent, entry and stop.

  • get_economic_calendarEconomic calendarread-only

    Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.

  • get_fear_greedFear and Greed indexread-only

    Crypto Fear and Greed index, current value and classification.

  • get_fundingFunding ratesread-only

    Current funding rates across exchanges - who pays whom to hold a perp position.

  • get_klinesOHLC candlesread-only

    OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.

  • get_liquidationsLiquidations (24h)read-only

    Recent real liquidation events aggregated from eight exchanges.

  • get_marketsTradable marketsread-only

    Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.

  • get_open_interestOpen interestread-only

    Open interest per symbol - how much leveraged money is committed.

  • get_priceLive priceread-only

    Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.

  • get_screenerSetup screenerread-only

    Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.

  • paper_accountsPaper booksread-only

    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_balancePaper account balanceread-only

    Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.

  • paper_cancel_orderCancel a resting ordercan change or delete data

    Cancel a resting limit order. Requires an API key.

  • paper_closeClose a paper positioncan change or delete data

    Close a simulated position, fully or partially. Requires an API key.

Show 14 more tools
  • paper_equityEquity curveread-only

    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_feesFee venue

    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.

  • paper_limit_orderPlace a limit or stop 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. Requires an API key.

  • paper_modify_orderModify a resting 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_openOpen a paper position

    Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.

  • paper_ordersResting ordersread-only

    Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.

  • paper_positionsPaper positionsread-only

    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_realismFill 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 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 …

  • paper_replayReplay a past day

    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.

  • paper_reportTrading reportread-only

    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_resetReset the paper bookcan change or delete data

    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_simSimulation profile

    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 fli…

  • paper_sltpSet stop / take-profit

    Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.

  • paper_tradesClosed paper tradesread-only

    Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.

Signals

Stars
0
Forks
0
Open issues
0
Last commit
Oct 16, 2026 (14 days ago)
Last release
Oct 10, 2026 (20 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.Marginpad/sdk
Version
3.0.0
Auth
API key
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get SDK running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying SDK?

CallGet help
Cite this page

SDK MCP server. Agent Mart. https://agentmart.dev/connectors/marginpad-sdk (last updated 2026-10-24)