kalshi_event

Pack: kalshi · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/kalshi_event for the schema, then POST the same URL with its arguments for the data.

A Kalshi event with every child market and its current odds, from the regulated US exchange.

Tool description as the model sees it

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, 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_ask_cents/yes_bid_cents/no_ask_cents + implied_yes_prob — required for most macro events since the nested response leaves prices null on the public unauth API). Every price ships TWO ways: *_cents rounded to the nearest cent (Kalshi’s display convention) and *_dollars at full fixed-point precision — a genuine sub-cent quote like 0.335 shows as 34 in yes_ask_cents and exactly 0.335 in yes_ask_dollars; use the dollars field for anything sizing a trade on a thin spread. implied_yes_prob is computed from the dollars value, not the rounded cents, so it carries the same precision. yes_bid_size/no_bid_size report top-of-book contract size for the two real resting sides when include_orderbook populated them from the orderbook ladder — there is no separate size for yes_ask/no_ask because those are derived prices (1 − the opposite side’s best bid), not an independent order. For cross-venue spreads vs Polymarket, see polymarket_kalshi_spread.

Parameters

NameTypeRequiredDescription
event_tickerstringyesKalshi event ticker, e.g. “KXFED-26OCT”
include_orderbookbooleannoDefault 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

FieldTypeDescription
foundboolean
eventobjectThe event record; absent when found is false
marketsarrayMarkets belonging to the event
Full JSON Schema
{
  "type": "object",
  "description": "A Kalshi event with its markets. The ticker is nested at event.event_ticker — there is no top-level event_ticker.",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "event": {
      "type": "object",
      "description": "The event record; absent when found is false",
      "properties": {
        "event_ticker": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "series_ticker": {
          "type": "string"
        }
      }
    },
    "markets": {
      "type": "array",
      "description": "Markets belonging to the event",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "found"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the kalshi pack
{
  "mcpServers": {
    "kalshi": {
      "url": "https://gateway.pipeworx.io/kalshi/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 5, 2026