`kalshi_event`

Pack: kalshi · Endpoint: https://gateway.pipeworx.io/kalshi/mcp

AUTHORITATIVE odds from Kalshi — the only CFTC-regulated US prediction-market exchange (US persons CAN legally trade here, unlike Polymarket). Returns one event with ALL its child markets nested: event title + each market’s ticker, subtitle, yes_ask price, volume. Use when you need the full partition for an outright bet (“Fed funds in June 2026: each rate level is one market”). Pass include_orderbook=true to fetch live top-of-book for each market (slower but populates yes_bid/yes_ask/no_bid/no_ask + implied_yes_prob — required for most macro events since the nested response leaves prices null on the public unauth API). For cross-venue spreads vs Polymarket, see polymarket_kalshi_spread.

Parameters

Name	Type	Required	Description
`event_ticker`	string	yes	Kalshi event ticker, e.g. “KXFED-26OCT”
`include_orderbook`	boolean	no	Default false. When true, fetches per-market orderbook in parallel and patches in best bid/ask + recomputed implied_yes_prob. Adds ~1s for events with ~10 markets. Required when the nested response returns null prices (common for macro events on the unauth API).

Example call

Arguments

{
  "event_ticker": "KXFED-26OCT"
}

curl

curl -X POST https://gateway.pipeworx.io/kalshi/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kalshi_event","arguments":{"event_ticker":"KXFED-26OCT"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('kalshi_event', {
  "event_ticker": "KXFED-26OCT"
});

Response shape

Always returns: found, event_ticker

Field	Type	Description
`found`	boolean	Whether event was found
`event_ticker`	string	Event ticker
`event`	object
`markets`	array	Child markets of the event

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "Whether event was found"
    },
    "event_ticker": {
      "type": "string",
      "description": "Event ticker"
    },
    "event": {
      "type": "object",
      "properties": {
        "event_ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "Event ticker"
        },
        "series_ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "Series ticker"
        },
        "title": {
          "type": [
            "string",
            "null"
          ],
          "description": "Event title"
        },
        "sub_title": {
          "type": [
            "string",
            "null"
          ],
          "description": "Event subtitle"
        },
        "category": {
          "type": [
            "string",
            "null"
          ],
          "description": "Event category"
        },
        "mutually_exclusive": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Markets are mutually exclusive"
        },
        "strike_date": {
          "type": [
            "string",
            "null"
          ],
          "description": "Strike/resolution date"
        },
        "strike_period": {
          "type": [
            "string",
            "null"
          ],
          "description": "Strike period"
        }
      }
    },
    "markets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": [
              "string",
              "null"
            ],
            "description": "Market ticker"
          },
          "event_ticker": {
            "type": [
              "string",
              "null"
            ],
            "description": "Parent event ticker"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Market title"
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ],
            "description": "Market subtitle"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "open|closed|settled"
          },
          "yes_ask_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Ask price in cents"
          },
          "yes_bid_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Bid price in cents"
          },
          "no_ask_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "NO ask price in cents"
          },
          "last_price_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Last trade price in cents"
          },
          "implied_yes_prob": {
            "type": [
              "number",
              "null"
            ],
            "description": "Implied YES probability (0-1)"
          },
          "volume": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total volume"
          },
          "volume_24h": {
            "type": [
              "number",
              "null"
            ],
            "description": "24-hour volume"
          },
          "open_interest": {
            "type": [
              "number",
              "null"
            ],
            "description": "Open interest"
          },
          "close_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Market close/expiration time"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Market category"
          }
        }
      },
      "description": "Child markets of the event"
    }
  },
  "required": [
    "found",
    "event_ticker"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "kalshi": {
      "url": "https://gateway.pipeworx.io/kalshi/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

kalshi_event