Create a paper trading account with a starting USD balance.

Writes the local account database; calling it again on an existing account replaces its balance. Run it before any trade; use reset_account to wipe trades and positions instead.

Get an account's cash, reserved and available cash, positions value and P&L.

Reads the local account and prices positions with live market data. Use portfolio for per-position detail and stats for performance metrics.

Delete an account's trades, positions and orders and reset its balance.

Irreversible local change. Use init_account to set a new starting balance afterwards; use cancel_all_orders to remove only pending orders.

Search Polymarket markets by text and return slug, question, prices and volume.

Queries the live Polymarket API and changes nothing. Searches Polymarket only: use kalshi_markets to find Kalshi markets, list_markets to browse by volume, or get_markets_by_tag to browse a category.

List active Polymarket markets, highest volume or liquidity first.

Queries the live Polymarket API and changes nothing. Use search_markets for a keyword, get_markets_by_tag for a category, or kalshi_markets for Kalshi.

Get one market's question, outcome prices, volume, liquidity and status.

Takes a Polymarket slug or condition ID, or a Kalshi market as 'kalshi:'. Reads live data and changes nothing; use get_order_book for depth.

Get the live asks and bids (price and size) for one market outcome.

Works for Polymarket slugs and for Kalshi markets as 'kalshi:'. Reads live data and changes nothing; check it before sizing a buy or sell.

List Kalshi markets for discovery; this tool is read-only and places no trade.

Reads the live Kalshi API. To trade a result, pass 'kalshi:' as slug_or_id to buy, sell or place_limit_order. Use search_markets or list_markets for Polymarket instead.

Get one Kalshi market by ticker; read-only discovery, no trade is placed.

Reads the live Kalshi API. To trade it, pass 'kalshi:' as slug_or_id to buy or sell. The same slug also works in get_market.

Get the live YES order book for a Kalshi market, best levels first; read-only.

Kalshi publishes bids only, so asks are derived from NO bids (a NO bid at p is a YES ask at 1 - p). get_order_book returns the same book for the slug 'kalshi:' and also covers the NO side.

List all Polymarket market categories (tags) with their slugs.

Reads the live Polymarket API and changes nothing. Pass a returned slug to get_markets_by_tag.

List open Polymarket markets in one category tag.

Reads the live Polymarket API and changes nothing. Get slugs from get_tags; use search_markets for a keyword or list_markets for the top markets overall.

Get a Polymarket event: the group of related markets sharing one topic.

Reads the live Polymarket API and changes nothing. Use get_market for a single market.

Get live midpoint prices for several markets and outcomes in one call.

Reads live data and changes nothing. Use get_order_book for depth on one market, or portfolio for prices of the positions you hold.

Buy shares of a Polymarket or Kalshi ('kalshi:') outcome with paper money.

Fills immediately against the live order book and records the trade and fee (simulated; no real order). Kalshi fees follow the series fee schedule. Use place_limit_order for a resting order at your price, or sell to exit.

Sell held shares of a Polymarket or Kalshi ('kalshi:') outcome for paper cash.

Fills immediately against the live order book and records the trade and fee (simulated; no real order). Use place_limit_order with side 'sell' to rest an exit at your price, or resolve to collect payout on a closed market.

List an account's open positions with live prices and unrealized P&L.

Reads the local account and prices positions with live market data. Use get_balance for cash totals, history for past trades, or stats for performance metrics.

List an account's recent trades with market, side, price, shares, USD and fee.

Reads the local database only (no network) and changes nothing. Use portfolio for open positions or stats for aggregate performance.

Place a resting paper limit order on a Polymarket or Kalshi ('kalshi:') market.

Stores the order locally and reserves cash for a buy; an order that crosses the book fills at once as a taker. Resting orders fill only when check_orders runs. Use buy or sell for an immediate market-price fill.

List an account's pending limit orders.

Reads the local database only and changes nothing. Use check_orders to evaluate them against live prices, or cancel_order to remove one.

Cancel one pending limit order by ID and release its reserved cash.

Local change only. Returns a not_found error if the order does not exist or is no longer pending. Use cancel_all_orders to cancel every pending order.

Cancel every pending limit order of an account and release the reserved cash.

Local change only; filled orders and open positions are untouched. Returns the count and the cancelled orders. Use cancel_order to cancel just one.

Evaluate pending limit orders against live prices and execute any that fill.

Writes fills and cash changes to the local account. Resting orders never fill on their own, so call this periodically. Use list_orders to only view pending orders.

Get one account's raw performance numbers: win rate, ROI, profit, Sharpe, max drawdown.

Reads the local account and prices positions live; changes nothing. Use this for analysis, stats_card for a postable text card, or leaderboard_entry for the ranking record.

Render one account's ROI, Sharpe, win rate and P&L as a postable text card.

Reads the local account and posts nothing. Open positions are valued at live midpoints (0 if a lookup fails). Use stats for raw numbers, share_content for platform and template choices, or pk_card to compare two accounts.

Return one account's standardized leaderboard record as JSON.

Includes ROI%, Sharpe, win rate, trade count, max drawdown, fees, first and last trade times, and 'qualified' (10+ trades). Reads the local account; Open positions are valued at live midpoints (0 if a lookup fails). Use leaderboard_card to rank many accounts, or stats for analysis.

Generate post-ready text for a platform and template from one account's stats.

Reads the local account and posts nothing. Open positions are valued at live midpoints (0 if a lookup fails). Use this when you need a template (milestone, daily); use stats_card for a plain stats card or stats for raw numbers.

Compare two existing accounts head-to-head and return a card naming the winner.

Compares ROI, Sharpe, win rate, trades and tier from local accounts. Open positions are valued at live midpoints (0 if a lookup fails). Use pk_battle to run two strategies from scratch instead, or stats_card for a single account.

Rank accounts with 10+ trades by ROI% and return a Top 10 leaderboard card.

Scans local accounts (~/.pm-trader locally, the caller's own directory in remote mode) and changes nothing. Open positions are valued at live midpoints (0 if a lookup fails). Use leaderboard_entry for one account's record or pk_card for two.

Run two strategies from scratch on equal balances and return stats, a PK card and the winner.

Executes the strategy functions against live market data in temporary accounts. Use pk_card to compare accounts that already exist, or backtest to test one strategy on historical data.

Settle an account's positions in one closed market, paying $1 per winning share.

Writes payouts to the local account and cancels resting orders on that market. Fails if the market is not closed, the winner is ambiguous, or no position is held. Use resolve_all to settle every closed market at once.

Settle every open position whose market has closed, paying $1 per winning share.

Writes payouts to the local account; open markets are skipped, as are markets that hit a transient network error (retry later). Use resolve to settle a single market.

Replay a strategy over historical price snapshots on synthetic order books.

Reads the data file and returns performance metrics; it does not touch your paper accounts. Use pk_battle to compare two strategies live, or stats for an account's real results.