`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 (sorted descending by price)
`no_bids`	array	NO side bid levels (sorted descending by price)
`note`	string	Explanation of price encoding and probability calculation

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Market ticker"
    },
    "yes_bids": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "price_cents": {
            "type": "number",
            "description": "Bid price in cents"
          },
          "quantity": {
            "type": "number",
            "description": "Size at this price level"
          }
        }
      },
      "description": "YES side bid levels (sorted descending by price)"
    },
    "no_bids": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "price_cents": {
            "type": "number",
            "description": "Bid price in cents"
          },
          "quantity": {
            "type": "number",
            "description": "Size at this price level"
          }
        }
      },
      "description": "NO side bid levels (sorted descending by price)"
    },
    "note": {
      "type": "string",
      "description": "Explanation of price encoding and probability calculation"
    }
  },
  "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