Prediction Market Intelligence

Use this first when the user asks what Polymarket thinks about a topic, how likely something is, or names a market without a link. Searches every Polymarket market by keyword (Polymarket's own full-text search) or by a polymarket.com link and returns events with all their outcomes, current prices, 24h volume and end dates, plus the slug to pass to the other tools. Use status='resolved' for past markets and how they settled.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Keywords (\"fed october\", \"bitcoin 150k\", \"house 2026\") or a polymarket.com link."
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "resolved",
        "all"
      ],
      "default": "open",
      "description": "open (default), resolved, or all."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Number of events to return (1–10, default 5)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks about one Polymarket market or event: its price, what exactly decides how it resolves, whether an outcome has been proposed or disputed, when it ends, its fees, or how it has moved. Returns prices, bid/ask and spread, change over 1h/24h/7d/30d with a 30-day range, volume and liquidity, taker fees, the resolution rules verbatim with their named source, and the live resolution status (not proposed / proposed and in its challenge window / disputed / resolved). For a multi-outcome event it lists every outcome and whether the prices add up to 100¢; add outcome to drill into one. Accepts a polymarket.com link or a slug from pm_search.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A polymarket.com link, or a market or event slug from pm_search."
    },
    "outcome": {
      "type": "string",
      "maxLength": 200,
      "description": "For a multi-outcome event: the outcome label to show in detail (\"25 bps decrease\")."
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks how liquid a Polymarket market is, how much a trade of a given size would really cost, how far it would move the price, or what the order book looks like. Returns the live book for one outcome: best levels, spread, dollar depth near the mid and which side is heavier. With amount it walks the book level by level for a market order (dollars to spend when buying, shares when selling) and returns shares filled, average and worst price, slippage against the mid, Polymarket's taker fee and the breakeven probability.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "A polymarket.com link, or a market or event slug from pm_search."
    },
    "outcome": {
      "type": "string",
      "maxLength": 200,
      "description": "Which outcome: \"Yes\"/\"No\", a team name, or for a multi-outcome event the outcome label (\"25 bps decrease\"). Default: the first outcome (usually Yes)."
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "default": "buy",
      "description": "buy (default) or sell."
    },
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000000,
      "description": "For buy: dollars to spend. For sell: number of shares to sell. Omit to see the book only."
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks who is buying or selling a Polymarket market, why its price moved, where the money is going, who the biggest holders are, or (with no market) what the whales are doing across Polymarket. For a market or event: dollars traded and net direction per outcome, distinct wallets, the largest trades, the wallets that moved the most money, and for a single market the biggest current holders. With no market: the largest trades across all of Polymarket and the markets drawing that money. Traders appear by public username when they set one; pass a wallet to pm_portfolio for its full track record.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "maxLength": 500,
      "description": "A polymarket.com link, or a market or event slug from pm_search. Omit to see the largest trades across all of Polymarket."
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 168,
      "default": 24,
      "description": "Look-back window in hours (1–168, default 24)."
    },
    "outcome": {
      "type": "string",
      "maxLength": 200,
      "description": "For a multi-outcome event: limit to one outcome by its label."
    },
    "min_usd": {
      "type": "number",
      "minimum": 1000,
      "maximum": 1000000,
      "default": 10000,
      "description": "Without a market: only trades of at least this many dollars (default $10,000)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks what is moving, trending or changing on Polymarket, what moved overnight or this week, or for the biggest gainers and losers. Ranks the 300 most-traded open markets by price change over the last hour, day, week or month, with old and current price, the move in percentage points, 24h volume and the slug for follow-ups (pm_flow shows who moved it). Markets that are merely settling and live sports games are left out unless include_games is true.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "1h",
        "24h",
        "7d",
        "30d"
      ],
      "default": "24h",
      "description": "Look-back window: 1h, 24h (default), 7d or 30d."
    },
    "direction": {
      "type": "string",
      "enum": [
        "both",
        "up",
        "down"
      ],
      "default": "both",
      "description": "both (default), up only, or down only."
    },
    "min_volume_24h_usd": {
      "type": "number",
      "minimum": 0,
      "default": 10000,
      "description": "Skip markets that traded less than this in the last 24h (default $10,000)."
    },
    "include_games": {
      "type": "boolean",
      "default": false,
      "description": "Include individual sports games, whose prices move with the score (default false)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Rows to return (1–20, default 10)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks who the best or biggest Polymarket traders are, who made the most money today, this week, this month or all time, or who leads in a category (politics, sports, crypto, economics, finance, culture, tech, weather, mentions). Returns Polymarket's own leaderboard ranked by profit or by volume, with usernames and wallet addresses to pass to pm_portfolio.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "all"
      ],
      "default": "week",
      "description": "day, week (default), month or all."
    },
    "by": {
      "type": "string",
      "enum": [
        "pnl",
        "volume"
      ],
      "default": "pnl",
      "description": "Rank by profit and loss (pnl, default) or by dollar volume."
    },
    "category": {
      "type": "string",
      "enum": [
        "overall",
        "politics",
        "sports",
        "crypto",
        "economics",
        "finance",
        "culture",
        "tech",
        "weather",
        "mentions"
      ],
      "default": "overall",
      "description": "overall (default) or one category."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Rows to return (1–25, default 10)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks what a Polymarket trader or wallet holds, how good a trader is, or wants to size up a wallet seen in pm_flow. Returns the track record (all-time and 30-day profit and loss, volume, leaderboard rank, markets traded), open positions with entry and current price, unrealized P&L, exposure grouped by event, settled winnings not yet redeemed, and recent trades. Accepts a 0x wallet address, a polymarket.com profile link or a Polymarket username. Public on-chain data only.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "minLength": 2,
      "maxLength": 300,
      "description": "0x wallet address, polymarket.com profile link (…/@name or …/profile/0x…), or Polymarket username."
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}