`kalshi_orderbook`

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_orderbook for the schema, then POST the same URL with its arguments for the data.

The live bid and ask ladder for one Kalshi market, from Kalshi.

Tool description as the model sees it

Current YES/NO orderbook (bids + asks with size, in cents) for a market ticker. Use to see live liquidity depth before judging whether an edge is tradable. Returns sorted price/quantity levels.

Parameters

Name	Type	Required	Description
`ticker`	string	yes	Kalshi market ticker
`depth`	number	no	Levels to return per side (default 5, max 100)

Example call

Arguments

{
  "ticker": "KXFED-26OCT-T3.50",
  "depth": 10
}

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_orderbook","arguments":{"ticker":"KXFED-26OCT-T3.50","depth":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('kalshi_orderbook', {
  "ticker": "KXFED-26OCT-T3.50",
  "depth": 10
});

Response shape

Always returns: ticker, yes_bids, no_bids, note

Field	Type	Description
`ticker`	string	Market ticker
`yes_bids`	array	YES side bid levels (best, i.e. highest, first)
`no_bids`	array	NO side bid levels (best, i.e. highest, first)
`note`	string	Explanation of price encoding and probability calculation
`levels_available`	object	Untrimmed ladder depth per side, so a thin book can be told from a trimmed one
`quoted`	boolean	false when nobody is resting an order on either side (Kalshi answers the same for a ticker that does not exist)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Market ticker"
    },
    "yes_bids": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "price_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Bid price in cents (full-precision, rounded to a whole cent)"
          },
          "price_dollars": {
            "type": "number",
            "description": "Bid price in dollars at Kalshi's full precision"
          },
          "quantity": {
            "type": "number",
            "description": "Size at this price level"
          }
        }
      },
      "description": "YES side bid levels (best, i.e. highest, first)"
    },
    "no_bids": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "price_cents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Bid price in cents (full-precision, rounded to a whole cent)"
          },
          "price_dollars": {
            "type": "number",
            "description": "Bid price in dollars at Kalshi's full precision"
          },
          "quantity": {
            "type": "number",
            "description": "Size at this price level"
          }
        }
      },
      "description": "NO side bid levels (best, i.e. highest, first)"
    },
    "note": {
      "type": "string",
      "description": "Explanation of price encoding and probability calculation"
    },
    "levels_available": {
      "type": "object",
      "properties": {
        "yes": {
          "type": "number"
        },
        "no": {
          "type": "number"
        }
      },
      "description": "Untrimmed ladder depth per side, so a thin book can be told from a trimmed one"
    },
    "quoted": {
      "type": "boolean",
      "description": "false when nobody is resting an order on either side (Kalshi answers the same for a ticker that does not exist)"
    }
  },
  "required": [
    "ticker",
    "yes_bids",
    "no_bids",
    "note"
  ]
}

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.

kalshi_orderbook