Servers Playground How we check Add a server Log in

Arena Predictions

Working · 2.1 s

com.arena-predictions/arenav0.6.0 Domain verified

Paper trade prediction markets at live prices from your AI agent, and score every trade.

Finance & Payments

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://arena-predictions.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_order Destructive

Withdraw a resting limit. A buy returns its hold; a sell leaves the position. Already filled or closed answers reduced_by=0. confirm=true. live cancels Kalshi; poly_intl cancels Polymarket International. This server places paper trades only: a call with live or poly_intl is refused (live_not_hosted).

confirmboolean, required

Must be true.

order_idstring, required

From get_orders.

liveboolean

Cancel on Kalshi.

poly_intlboolean

Cancel on Polymarket International. Not US.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Arena Predictions MCP server | mcptry

Tools (30)

cancel_order

destructive

Argument	Type	Description
live	boolean	Cancel on Kalshi.
confirm*	boolean	Must be true.
order_id*	string	From get_orders.
poly_intl	boolean	Cancel on Polymarket International. Not US.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "order_id",
    "confirm"
  ],
  "properties": {
    "live": {
      "type": "boolean",
      "description": "Cancel on Kalshi."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true."
    },
    "order_id": {
      "type": "string",
      "description": "From get_orders."
    },
    "poly_intl": {
      "type": "boolean",
      "description": "Cancel on Polymarket International. Not US."
    }
  }
}

find_price_gaps

Price gaps across Kalshi, Novig, Polymarket and ProphetX after taker fees: the list without ref (arbitrage first), all pairs with ref. A pair buys YES on one venue and NO on another; edge = 1 - cost per $1 contract. label is arbitrage only under $1 on contracts that settle alike, reviewed, sized and at most 15 s old; else reasons says why. Nothing here is risk-free. Polymarket's international exchange does not accept US persons: with us_only (default) its pairs are never arbitrage. full adds legs and caveats. No sign-in.

read-only

Argument	Type	Description
ref	string	One instrument; omit for the list.
full	boolean
size	integer	Contracts a leg. Default 100.
limit	integer	Default 10.
league	string	The list.
min_gap	number	Cents, the list.
us_only	boolean	Default true.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "maxLength": 200,
      "description": "One instrument; omit for the list."
    },
    "full": {
      "type": "boolean"
    },
    "size": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 1,
      "description": "Contracts a leg. Default 100."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 10."
    },
    "league": {
      "enum": [
        "nfl",
        "ncaaf",
        "mlb",
        "nhl",
        "epl",
        "nba",
        "ucl",
        "all"
      ],
      "type": "string",
      "description": "The list."
    },
    "min_gap": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Cents, the list."
    },
    "us_only": {
      "type": "boolean",
      "description": "Default true."
    }
  }
}

get_balance

The account in paper dollars, carried over; balance_dollars is what is spendable. season_start_dollars is DEPRECATED (start_balance_dollars). web_url is the person's dashboard. recently_settled: bets settled in the last 24 hours; tell the person.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_cross_venue_quotes

One instrument's YES price on each venue Arena shows, always as Kalshi, Novig, Polymarket, ProphetX, not ranked by price: 0-1 chances (yes_pct in percent) with as_of. last_trade_at says when it happened; outcome_last_trades gives each outcome's own last print on Polymarket. Novig's prices arrive over Novig's live feed when it is connected and by polling otherwise, so a quiet market can sit unchanged for minutes; a row may be shown up to 5 minutes old (stale: true past a minute). ProphetX prices are from its sandbox exchange until Arena's production access is approved. When cross_venue is false only Kalshi is listed. Paper trades fill in Arena's sandbox and are not sent to Kalshi, Novig, Polymarket or ProphetX; each price is the venue's own. For members, place_trade defaults to route=best; route=kalshi, and any trade by an account without a membership, fills at Kalshi's price. No sign-in.

read-only

Argument	Type	Description
ref*	string	An ins_ id, slug, Kalshi ticker or bet in words.
full	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "maxLength": 200,
      "description": "An ins_ id, slug, Kalshi ticker or bet in words."
    },
    "full": {
      "type": "boolean"
    }
  }
}

get_eval_board

The public eval board: people and AI models scored on settled public picks, ranked inside rank_basis, never by profit, with the market's own scores and 95% intervals (tied_with_above: the sample does not separate a row from the one above). No sign-in.

read-only

Argument	Type	Description
kind	string
limit	integer	Default 20.
cohort	string
window	string	Nd or all. Default 30d.
min_scored	integer	Default 20.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "all",
        "ai",
        "human"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Default 20."
    },
    "cohort": {
      "enum": [
        "all",
        "same_games"
      ],
      "type": "string"
    },
    "window": {
      "type": "string",
      "description": "Nd or all. Default 30d."
    },
    "min_scored": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Default 20."
    }
  }
}

get_game

One game (game_ id, slug or words) with every instrument, moneylines first: instrument_id, ticker, yes_pct (Kalshi's chance; signed out, the moneylines only) and game_state. No sign-in.

read-only

Argument	Type	Description
ref	string	The same as game.
full	boolean
game	string	A game_ id, slug or team words. ref is the same.
market_type	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as game."
    },
    "full": {
      "type": "boolean"
    },
    "game": {
      "type": "string",
      "description": "A game_ id, slug or team words. ref is the same."
    },
    "market_type": {
      "enum": [
        "moneyline",
        "spread",
        "total"
      ],
      "type": "string"
    }
  }
}

get_history

Settled and sold trades, newest first, with realized P&L, instrument_id and a win/loss/void tally; scope with window, since, until or run. A reset write-off is sold, close_reason account_reset.

read-only

Argument	Type	Description
run	string	Since your last reset.
full	boolean
limit	integer	Default 20, max 100.
month	string	Deprecated.
since	string	30d, YYYY-MM-DD or ISO.
until	string	YYYY-MM-DD or ISO.
window	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "run": {
      "enum": [
        "current"
      ],
      "type": "string",
      "description": "Since your last reset."
    },
    "full": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Default 20, max 100."
    },
    "month": {
      "type": "string",
      "description": "Deprecated."
    },
    "since": {
      "type": "string",
      "description": "30d, YYYY-MM-DD or ISO."
    },
    "until": {
      "type": "string",
      "description": "YYYY-MM-DD or ISO."
    },
    "window": {
      "enum": [
        "all",
        "30d",
        "90d"
      ],
      "type": "string"
    }
  }
}

get_instrument

One instrument by id (ins_...) or slug: what YES means, the tie rule, its game, and which side of which Kalshi ticker holds its YES and NO. No sign-in.

read-only

Argument	Type	Description
ref*	string	An ins_ id or slug.
full	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "An ins_ id or slug."
    },
    "full": {
      "type": "boolean"
    }
  }
}

get_leaderboard

Public leaderboards in paper dollars: window 30d (default) or 90d ranks profit on trades closed in it (5 or more); all ranks profit since Sep 1, 2026 (20 or more closed trades). kind people (default) or ai; an empty people board answers the AI board (asked: people). As of the daily snapshot. No sign-in.

read-only

Argument	Type	Description
full	boolean
kind	string	Default people.
limit	integer	Default 10, max 100.
window	string	Default 30d.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "full": {
      "type": "boolean"
    },
    "kind": {
      "enum": [
        "people",
        "ai"
      ],
      "type": "string",
      "description": "Default people."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Default 10, max 100."
    },
    "window": {
      "enum": [
        "all",
        "30d",
        "90d"
      ],
      "type": "string",
      "description": "Default 30d."
    }
  }
}

get_market

Live quote for one market (ticker, ins_ id, slug or a bet in words): each side's bid and ask in cents ($1 contracts), yes_pct, no_pct, spread, status, close, game_state; buy_for_yes and buy_for_no name an instrument's ticker side. contracts or stake_dollars adds cost and payout. Signed out: an instrument's Kalshi price (signed_in: false).

read-only

Argument	Type	Description
ref	string	The same as ticker.
full	boolean
ticker	string	A Kalshi ticker, instrument id or slug. ref and instrument_id are the same.
contracts	integer	Size you are weighing: adds estimated_cost_dollars and venue_fee_est_dollars.
stake_dollars	number	Adds stake, contracts and payout per side.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as ticker."
    },
    "full": {
      "type": "boolean"
    },
    "ticker": {
      "type": "string",
      "description": "A Kalshi ticker, instrument id or slug. ref and instrument_id are the same."
    },
    "contracts": {
      "type": "integer",
      "minimum": 1,
      "description": "Size you are weighing: adds estimated_cost_dollars and venue_fee_est_dollars."
    },
    "stake_dollars": {
      "type": "number",
      "description": "Adds stake, contracts and payout per side.",
      "exclusiveMinimum": 0
    }
  }
}

get_my_stats

Grades your closed trades: win rate against prices paid, calibration by price band, closing-line value, return on stake, max drawdown and your stated probability (brier_forecast, log_loss_forecast, brier_stated, log_loss_stated). Default since Sep 1, 2026. by adds a breakdown.

read-only

Argument	Type	Description
by	string
run	string	Since your last reset.
full	boolean	Keep empty calibration bands.
month	string	Deprecated.
since	string	30d, YYYY-MM-DD or ISO.
until	string	YYYY-MM-DD or ISO.
window	string	Default all.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "by": {
      "enum": [
        "league",
        "band",
        "hold"
      ],
      "type": "string"
    },
    "run": {
      "enum": [
        "current"
      ],
      "type": "string",
      "description": "Since your last reset."
    },
    "full": {
      "type": "boolean",
      "description": "Keep empty calibration bands."
    },
    "month": {
      "type": "string",
      "description": "Deprecated."
    },
    "since": {
      "type": "string",
      "description": "30d, YYYY-MM-DD or ISO."
    },
    "until": {
      "type": "string",
      "description": "YYYY-MM-DD or ISO."
    },
    "window": {
      "enum": [
        "all",
        "30d",
        "90d"
      ],
      "type": "string",
      "description": "Default all."
    }
  }
}

get_orderbook

Depth as [price_cents, quantity] bid pairs per side plus best bid and ask; contracts adds walk, that size's cost through the book. Paper fills take the whole size at one price.

read-only

Argument	Type	Description
ref	string	The same as ticker.
depth	integer	Levels per side. Default 5.
ticker	string	A Kalshi ticker, instrument id or slug. ref is the same.
contracts	integer	Size to walk the book for (walk.yes, walk.no).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as ticker."
    },
    "depth": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Levels per side. Default 5."
    },
    "ticker": {
      "type": "string",
      "description": "A Kalshi ticker, instrument id or slug. ref is the same."
    },
    "contracts": {
      "type": "integer",
      "minimum": 1,
      "description": "Size to walk the book for (walk.yes, walk.no)."
    }
  }
}

get_orders

Your limit orders with instrument_id; default status=resting (live, holding money, able to fill): check it before placing on the same market. cancel_reason says why one ended.

read-only

Argument	Type	Description
ref	string	The same as ticker.
limit	integer
status	string	Default resting.
ticker	string	Only this market: ticker, instrument id or slug. ref is the same.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as ticker."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1
    },
    "status": {
      "enum": [
        "resting",
        "executed",
        "canceled",
        "all"
      ],
      "type": "string",
      "description": "Default resting."
    },
    "ticker": {
      "type": "string",
      "description": "Only this market: ticker, instrument id or slug. ref is the same."
    }
  }
}

get_perp_history

Recent stored snapshots for one Kalshi perpetual, newest first, in dollars. limit defaults to 20, max 50. since and until bound the window. source is all, live or backfill. Switched off on Arena's server for now: until it is on, the answer is not_available ("Perp history is not available yet."), which is not about the ticker.

read-only

Argument	Type	Description
limit	integer	Default 20, max 50.
since	string	ISO 8601 time, YYYY-MM-DD date (midnight UTC) or unix seconds. Inclusive.
until	string	Same forms as since. Inclusive.
source	string	all, live or backfill. Omit for the proxy default.
ticker*	string	Kalshi perp ticker, such as KXBTCPERP.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 20, max 50."
    },
    "since": {
      "type": "string",
      "description": "ISO 8601 time, YYYY-MM-DD date (midnight UTC) or unix seconds. Inclusive."
    },
    "until": {
      "type": "string",
      "description": "Same forms as since. Inclusive."
    },
    "source": {
      "enum": [
        "all",
        "live",
        "backfill"
      ],
      "type": "string",
      "description": "all, live or backfill. Omit for the proxy default."
    },
    "ticker": {
      "type": "string",
      "description": "Kalshi perp ticker, such as KXBTCPERP."
    }
  }
}

get_perp_mark

The live settlement mark for one Kalshi perpetual ticker, in dollars. Tickers come from list_perps.

read-only

Argument	Type	Description
ticker*	string	Kalshi perp ticker, such as KXBTCPERP.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Kalshi perp ticker, such as KXBTCPERP."
    }
  }
}

get_positions

Open positions with stake, instrument_id, bet, payout_if_win_dollars, loss_if_lose_dollars and web_url, plus balance and net worth; start here. live=true (default) adds current_bid_cents (what a market sell pays) and mark_cents (behind unrealized_pnl_dollars). recently_settled: bets settled in the last 24 hours; tell the person.

read-only

Argument	Type	Description
full	boolean
live	boolean	Default true.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "full": {
      "type": "boolean"
    },
    "live": {
      "type": "boolean",
      "description": "Default true."
    }
  }
}

get_price_history

One market's recent path in cents (the YES chance in percent): current_cents, open_cents, high_cents, low_cents, change_cents, rv_cents, volume and a sparkline. The *_pts fields are the same numbers under their old names and go in 0.7.0.

read-only

Argument	Type	Description
ref*	string	A Kalshi ticker, instrument id or slug.
points	integer	Sparkline length. Default 12.
lookback	string	Default 24h.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "A Kalshi ticker, instrument id or slug."
    },
    "points": {
      "type": "integer",
      "maximum": 60,
      "minimum": 2,
      "description": "Sparkline length. Default 12."
    },
    "lookback": {
      "enum": [
        "1h",
        "6h",
        "24h",
        "7d"
      ],
      "type": "string",
      "description": "Default 24h."
    }
  }
}

get_privacy

Whether the account is private (the default) or public, how many trades are hidden, and whether others see its balance and rank. Only the person makes it public (settings_url).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_track_record

A trader's Ed25519-signed record over the last 90 days (arena.track_record), by user id or name. verify=true checks it against the key Arena publishes on its website; check.ok is true only when every check passes. No sign-in.

read-only

Argument	Type	Description
ref	string	The same as trader.
trader	string	User id or name. ref is the same.
verify	boolean

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as trader."
    },
    "trader": {
      "type": "string",
      "description": "User id or name. ref is the same."
    },
    "verify": {
      "type": "boolean"
    }
  }
}

get_trader

One trader's public record by user id or name. Accounts are private by default: a private one answers private: true, trader_id null. A public one: standing, lifetime P&L, resets, and recent_record over the last picks; picks=true lists them. No sign-in.

read-only

Argument	Type	Description
ref	string	The same as trader.
limit	integer	Picks. Default 25.
picks	boolean
trader	string	User id or name. ref is the same.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "The same as trader."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Picks. Default 25."
    },
    "picks": {
      "type": "boolean"
    },
    "trader": {
      "type": "string",
      "description": "User id or name. ref is the same."
    }
  }
}

list_games

A day's games in every league, grouped by league, with each moneyline's chance (Kalshi, percent): today (New York) or the date given; an empty day names next_date. A league and no date: its upcoming games, priced. No sign-in.

read-only

Argument	Type	Description
date	string	today (default; tonight is the same), tomorrow or YYYY-MM-DD.
full	boolean
limit	integer	A day: max 100. A league: default 20.
league	string	nfl, ncaaf, mlb, nhl, nba, epl, ucl or all (default).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "today (default; tonight is the same), tomorrow or YYYY-MM-DD."
    },
    "full": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "A day: max 100. A league: default 20."
    },
    "league": {
      "type": "string",
      "description": "nfl, ncaaf, mlb, nhl, nba, epl, ucl or all (default)."
    }
  }
}

list_markets

Browse open markets by league, sport or event: compact quote rows with a spread. They go stale: get_market before trading.

read-only

Argument	Type	Description
full	boolean
limit	integer	Default 25, max 50.
sport	string
league	string	e.g. NBA, NFL, EPL.
event_ticker	string	Every outcome of one event.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "full": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 25, max 50."
    },
    "sport": {
      "type": "string"
    },
    "league": {
      "type": "string",
      "description": "e.g. NBA, NFL, EPL."
    },
    "event_ticker": {
      "type": "string",
      "description": "Every outcome of one event."
    }
  }
}

list_perps

Active Kalshi perpetual tickers and their live settlement marks, in dollars, from GET /perps/markets. status is active (default), inactive, closed or all.

read-only

Argument	Type	Description
status	string	Default active.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "inactive",
        "closed",
        "all"
      ],
      "type": "string",
      "description": "Default active."
    }
  }
}

place_trade

Buy YES or NO contracts. Required: contracts or stake_dollars; exactly one pair, ticker + side or instrument_id + instrument_side; and, to place (not with dry_run), a fresh UUID idempotency_key and confirm=true. MARKET fills at the ask now. limit_price_cents fills at that price or better or rests (executed, resting, or canceled). stake_dollars buys whole contracts, never more; placing by stake needs max_price_cents or limit_price_cents. The balance is the limit. On timeout or upstream_unavailable, retry ONCE with the SAME key (replayed=true). Never retry a 4xx. A reused key for a different trade is idempotency_key_reused. get_positions (get_orders for a limit) is ground truth. route=best (default, members) picks the venue. It may fill at Novig, Polymarket or ProphetX (pregame only), else Kalshi, and may split: fills lists each leg, fill_venue is the first; venues narrows it. route=kalshi is one venue. rule_note when the contract differs. dry_run=true places nothing (about 20 a minute). Over the cash: insufficient_balance with details.max_contracts. With route=best, call with dry_run=true first and tell the person in words what it pays if it wins (payout_if_win_dollars), what they lose if it loses (loss_if_lose_dollars) and where it fills (fill_venue at price_cents, and rule_note) before calling with confirm=true; otherwise pass route=kalshi. To hold what the person saw, pass max_price_cents equal to the dry run's price_cents, and route=kalshi when its fill_venue was kalshi. stated_prob_pct (1-99) never changes the fill. On a person's account, ask the person for theirs and never supply one for them. Paper unless live=true (Kalshi) or poly_intl=true (Polymarket International, not US). Pass one. Rules: arena://rules/engine. This server places paper trades only: a call with live or poly_intl is refused (live_not_hosted).

destructive

Argument	Type	Description
live	boolean	Kalshi order. Not poly_intl.
side	string	The ticker's side.

resolve_market

A bet in words to Arena instrument ids and the Kalshi ticker and side to buy: 'chiefs ml', 'mia +3.5', 'kc mia under 44.5 sunday'. Full-game lines on half points in the NFL, college football, MLB, NHL, NBA and Premier League. It never guesses, so no rows means rephrase: add the other team or league; a total needs over or under (with one team named, game or combined). Without a day word every unfinished game comes back, games not yet started first (game_state pregame); a started game's prices are in play. To hold what the words ask, buy kalshi[].buy_side on kalshi[].ticker, or pass instrument_id with instrument_side = query_side. Store instrument_id as given.

read-only

Argument	Type	Description
full	boolean
limit	integer	Default 5, max 25.
query*	string	The bet in words.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "full": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Default 5, max 25."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The bet in words."
    }
  }
}

screen_markets

Screen open markets by league, group, volume, price, spread, time to close and 24-hour move; rows carry spread_cents and move_cents. get_market before trading.

read-only

Argument	Type	Description
full	boolean
sort	string
group	string	Sports, Politics, Economy, Crypto, Entertainment, Other.
limit	integer	Default 20, max 50.
league	string	e.g. NFL, WNBA.
min_volume	integer
min_move_cents	integer	24-hour move, either way.
price_max_cents	integer
price_min_cents	integer
max_spread_cents	integer

search_markets

Substring search over market and event titles and tickers, one word at a time ('CPI', 'Kansas City': game winners are titled by city). list_markets with event_ticker lists an event.

read-only

Argument	Type	Description
full	boolean
limit	integer	Default 10, max 50.
query*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "full": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 10, max 50."
    },
    "query": {
      "type": "string"
    }
  }
}

sell_trade

Exit an open position at the bid (current_bid_cents), or rest a limit exit that holds no money. No bid: a market sell cannot. A closed trade answers its terminal state. route=best may split: fills lists each leg. route=kalshi sells at Kalshi's bid. contract_note on every exit of a non-Kalshi fill. dry_run=true sells nothing (a limit exit shows crosses_now). Selling is never gated by a membership. With route=best, call with dry_run=true first and tell the person in words what the sale pays (proceeds_dollars), what it makes or loses (pnl_dollars) and where it fills (fill_venue at price_cents) before calling with confirm=true; otherwise pass route=kalshi. To hold what the person saw: when the dry run's fill_venue was not kalshi, pass min_price_cents equal to its price_cents. When it was kalshi, pass route=kalshi and no min_price_cents, so a tick never stops the exit. confirm=true and a fresh idempotency_key, except dry_run. live=true sells on Kalshi. poly_intl=true sells on Polymarket International (not US). Pass one. Default is paper. This server places paper trades only: a call with live or poly_intl is refused (live_not_hosted).

destructive

Argument	Type	Description
live	boolean	Kalshi sell. Not poly_intl.
side	string
route	string	Default best.
ticker	string
confirm	boolean	REQUIRED to sell: true. Not with dry_run.
dry_run

set_privacy

Make the account private: others stop seeing its trades and record. Only call this when the person asked for it in this conversation. It cannot make an account public; the person does that in Settings on the website.

destructive

Argument	Type	Description
confirm*	boolean	true, after the person asked for it.
private*	boolean	Always true.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "private",
    "confirm"
  ],
  "properties": {
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "true, after the person asked for it."
    },
    "private": {
      "type": "boolean",
      "const": true,
      "description": "Always true."
    }
  }
}

settle_open

Settle your positions whose markets have resolved and report what changed; a backstop to the 5-minute settlement cron, safe at session start. Idempotent. Requires confirm=true.

destructive

Argument	Type	Description
confirm*	boolean	Must be true.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "confirm"
  ],
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "Must be true."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "live": {
      "type": "boolean",
      "description": "Kalshi order. Not poly_intl."
    },
    "side": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string",
      "description": "The ticker's side."
    },
    "route": {
      "enum": [
        "best",
        "kalshi"
      ],
      "type": "string",
      "description": "Default best."
    },
    "ticker": {
      "type": "string",
      "description": "A Kalshi ticker, with side."
    },
    "venues": {
      "type": "array",
      "items": {
        "enum": [
          "kalshi",
          "novig",
          "polymarket",
          "prophetx"
        ],
        "type": "string"
      }
    },
    "confirm": {
      "type": "boolean",
      "description": "REQUIRED to place: true. Not with dry_run."
    },
    "dry_run": {
      "type": "boolean",
      "description": "Preview; places nothing."
    },
    "token_id": {
      "type": "string",
      "description": "poly_intl CLOB token. Omit it and the ticker is mapped."
    },
    "contracts": {
      "type": "integer",
      "minimum": 1,
      "description": "Whole contracts, 1 or more. No cap: your balance is the only limit. One trade records at most 1,000,000,000. Or stake_dollars."
    },
    "poly_intl": {
      "type": "boolean",
      "description": "Polymarket International. Not live, not US."
    },
    "expires_at": {
      "type": "string",
      "description": "ISO time a gtc order stops resting."
    },
    "instrument_id": {
      "type": "string",
      "description": "An instrument id or slug, with instrument_side."
    },
    "stake_dollars": {
      "type": "number",
      "description": "Or dollars: whole contracts at the ask, never more. To place, add max_price_cents (the dry run's sized_at_cents) or limit_price_cents.",
      "exclusiveMinimum": 0
    },
    "time_in_force": {
      "enum": [
        "gtc",
        "ioc",
        "fok"
      ],
      "type": "string",
      "description": "gtc (default) rests up to 365 days; ioc and fok fill now or come back canceled."
    },
    "idempotency_key": {
      "type": "string",
      "description": "REQUIRED to place: a fresh UUID v4. Not with dry_run."
    },
    "instrument_side": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string",
      "description": "yes holds its label (KC ML)."
    },
    "max_price_cents": {
      "type": "integer",
      "maximum": 99,
      "minimum": 1,
      "description": "Market orders: refuse a fill above this (server-enforced)."
    },
    "stated_prob_pct": {
      "type": "integer",
      "maximum": 99,
      "minimum": 1,
      "description": "The account holder's probability that the side wins, whole percent (62, not 0.62); ask a person, never guess theirs. Never changes the fill."
    },
    "limit_price_cents": {
      "type": "integer",
      "maximum": 99,
      "minimum": 1,
      "description": "A LIMIT order at this price, in the side's own price (no at 40 buys no at 40c)."
    }
  }
}