kalshi_markets
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_markets for the schema, then POST the same URL with its arguments for the data.
Kalshi prediction markets matching a filter, each with its live Yes/No price.
Tool description as the model sees it
List or search Kalshi prediction markets, open or already settled. Pass keyword to find markets by subject — “inflation”, “Iran”, “Vance” — served by Kalshi’s own full-corpus search, with each result tagged match: market|event|related so you can tell a literal keyword hit from a relevance-ranked neighbor. A keyword search honours status, so status “settled” is how you find a RESOLVED market by subject (its result is the outcome) — Kalshi indexes settled markets separately and the open index does not contain them. Other filters: status (open|closed|settled|unopened), event_ticker (group by event), series_ticker (group by series like KXFED for Fed rate). EVERY path returns the same fields — ticker, event_ticker, series_ticker, title, subtitle, status, yes_ask/yes_bid/no_ask/last_price (cents 1–99), implied_yes_prob, volume, volume_24h, open_interest, liquidity, close_time, category, result — so you can screen by category AND liquidity in one call. Two fields are conditional and say so here rather than surprising you: result is the settled outcome (“yes”/“no”) and is null while a market is still trading, and category comes from the market’s Kalshi series (Kalshi’s market records carry none), so it is null for the rare market whose series lookup fails — listed in fields_omitted when that happens. A keyword search adds two fields a listing has no notion of: event_title and match. Anything we cannot populate is named in fields_omitted rather than returned as a bare null. Use this to discover markets; use kalshi_market for the rules text.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | no | Subject to search for, e.g. “inflation”, “Iran”, “Vance”. Runs Kalshi’s own search over the full market corpus, in the slice named by status — pass status “settled” to find markets that have already RESOLVED (they carry result), which the default open index does not contain. Word-boundary matched, so “Vance” will not match “advance”. |
status | string | no | open | closed | settled (default open) |
event_ticker | string | no | Filter to one event (e.g. “KXFED-26OCT”) |
series_ticker | string | no | Filter to one series (e.g. “KXFED” for Fed funds rate) |
limit | number | no | 1-1000 (default 100) |
cursor | string | no | Pagination cursor from previous response |
Example call
Arguments
{
"keyword": "inflation"
}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_markets","arguments":{"keyword":"inflation"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('kalshi_markets', {
"keyword": "inflation"
});More examples
{
"status": "open",
"limit": 50
}{
"series_ticker": "KXFED",
"limit": 100
}{
"keyword": "2024 presidential election",
"status": "settled",
"limit": 5
}Response shape
Full JSON Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of markets returned"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Pagination cursor for next batch"
},
"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": "List of formatted markets"
},
"found": {
"type": "boolean",
"enum": [
true
],
"description": "Present and true on an answer; a miss is the found:false branch."
},
"keyword": {
"type": "string"
},
"source": {
"type": "string"
},
"searched_status": {
"type": "string"
},
"total_results_count": {
"type": "number"
},
"direct_matches": {
"type": "number"
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"keyword_only_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"note": {
"type": "string"
}
},
"required": [
"count",
"markets"
]
},
{
"type": "object",
"description": "A miss or an unavailable upstream: found:false with a reason and a hint (the shape check-found-false-schemas.mjs expects).",
"properties": {
"found": {
"type": "boolean",
"enum": [
false
]
}
},
"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.