{ "openapi": "3.0.1", "info": { "title": "Event Contract Odds - Kalshi API Scraper, Order Book, Trades", "description": "135,440 open Kalshi markets across 15,625 events in 77.3 seconds; the flat list is 99.1% parlay shards. Up to 99 fields. Prediction market data on event contracts: implied probability, spread, Kalshi trades and OHLC candles. Monitor mode emits only markets whose odds moved.", "version": "0.1", "x-build-id": "oiTcqDohGGeVCFRvQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/snow_leo_data~kalshi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-snow_leo_data-kalshi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/snow_leo_data~kalshi-scraper/runs": { "post": { "operationId": "runs-sync-snow_leo_data-kalshi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/snow_leo_data~kalshi-scraper/run-sync": { "post": { "operationId": "run-sync-snow_leo_data-kalshi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Keyword", "type": "string", "description": "Case-insensitive substring matched against the market question, the yes/no outcome labels, the ticker and the event title. Leave empty to take the whole feed." }, "resultType": { "title": "What to return", "enum": [ "markets", "events", "trades" ], "type": "string", "description": "markets — one row per tradable contract (default). events — one row per event with its markets nested and the event priced as a whole. trades — the exchange-wide trade tape.", "default": "markets" }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many rows. 0 means no limit: a full open-market sweep is 135,440 rows and takes about 77.3 seconds of API time (measured 2026-09-12). A run with no limit AND no filters stops at 100 rows, so an accidental full sweep cannot surprise you; with any filter set, 0 really means everything that matches.", "default": 100 }, "categories": { "title": "Categories", "type": "array", "description": "Exchange categories with the number of open events measured on the live feed 2026-09-12: Sports 9,142, Elections 3,321, Entertainment 753, Politics 637, Financials 610, Economics 526, Climate and Weather 209.", "items": { "type": "string", "enum": [ "Sports", "Elections", "Entertainment", "Politics", "Financials", "Economics", "Climate and Weather", "Science and Technology", "Crypto", "Companies", "Mentions", "Commodities", "Social", "World", "Health", "AI", "Transportation", "Business" ], "enumTitles": [ "Sports - 9,142 events", "Elections - 3,321 events", "Entertainment - 753 events", "Politics - 637 events", "Financials - 610 events", "Economics - 526 events", "Climate and Weather - 209 events", "Science and Technology - 139 events", "Crypto - 91 events", "Companies - 79 events", "Mentions - 48 events", "Commodities - 42 events", "Social - 9 events", "World - 6 events", "Health - 6 events", "AI - 4 events", "Transportation - 1 events", "Business - 1 events" ] }, "default": [] }, "status": { "title": "Market status", "enum": [ "open", "closed", "settled", "unopened" ], "type": "string", "description": "open covers everything currently tradable. closed and settled give the historical and settlement view, including the result of each contract.", "default": "open" }, "seriesTickers": { "title": "Series tickers", "type": "array", "description": "Server-side filter, the cheapest way to follow one topic: KXFED (Fed funds rate), KXNFLGAME (NFL games), KXHIGHNY (New York daily high temperature). A kalshi.com link pasted here works too — the ticker is taken out of it.", "default": [], "items": { "type": "string" } }, "eventTickers": { "title": "Event tickers", "type": "array", "description": "Fetch named events directly, one request each, e.g. KXFED-27APR. Faster than sweeping when you already know what you want.", "default": [], "items": { "type": "string" } }, "tickers": { "title": "Market tickers", "type": "array", "description": "Keep only these contract tickers, e.g. KXFED-27APR-T4.25. In trade-tape mode this selects whose trades are returned.", "default": [], "items": { "type": "string" } }, "minVolume24h": { "title": "Min 24h volume", "minimum": 0, "type": "integer", "description": "Contracts traded in the last 24 hours. Set 1 to keep only markets that traded at all today." }, "minVolume": { "title": "Min lifetime volume", "minimum": 0, "type": "integer", "description": "Total contracts traded since the market opened." }, "minOpenInterest": { "title": "Min open interest", "minimum": 0, "type": "integer", "description": "Contracts still outstanding. A better liveness signal than volume: it means money is at risk right now, not that a trade once happened." }, "minLiquidity": { "title": "Min resting liquidity, USD", "minimum": 0, "type": "integer", "description": "Dollars resting in the book as reported by the exchange feed. Many markets report 0 here, so any non-zero value filters hard." }, "minPrice": { "title": "Min yes ask", "type": "string", "description": "Lower bound on the yes ask in dollars, 0 to 1. Use 0.9 for near-certain outcomes." }, "maxPrice": { "title": "Max yes ask", "type": "string", "description": "Upper bound on the yes ask in dollars, 0 to 1. Use 0.1 to list longshots only." }, "closingWithinHours": { "title": "Closing within hours", "minimum": 0, "type": "integer", "description": "Keep only markets that close inside this many hours from now." }, "includeOrderBook": { "title": "Include order book", "type": "boolean", "description": "Resting bids on both sides plus computed depth in contracts and dollars, and the yes/no imbalance. Costs one extra API request per returned market.", "default": false }, "orderBookDepth": { "title": "Order book depth", "minimum": 1, "maximum": 100, "type": "integer", "description": "Price levels per side.", "default": 10 }, "includeTrades": { "title": "Include recent trades", "type": "boolean", "description": "Last trades on the market, plus time since the last trade, recent VWAP and the taker-side split.", "default": false }, "tradesPerMarket": { "title": "Trades per market", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many recent trades to fetch per market.", "default": 20 }, "includeCandles": { "title": "Include price history", "type": "boolean", "description": "OHLC candles for the lookback window, plus the window high, low and net change.", "default": false }, "candleLookbackHours": { "title": "Candle lookback", "minimum": 1, "maximum": 8760, "type": "integer", "description": "How far back the candle window reaches.", "default": 24 }, "candlePeriodMinutes": { "title": "Candle period", "enum": [ "1", "60", "1440" ], "type": "string", "description": "Minutes per candle. The exchange serves 1, 60 and 1440.", "default": "60" }, "includeSeries": { "title": "Include series metadata", "type": "boolean", "description": "Series title, publishing frequency, tags, fee type and the contract-terms PDF. The dictionary is cached between runs, so the second run asks for nothing.", "default": false }, "tradeTapeHours": { "title": "Trade tape window", "type": "string", "description": "Used in trade-tape mode only: how far back the tape is read, in hours.", "default": "1" }, "onlyChanged": { "title": "Monitor mode", "type": "boolean", "description": "Remember what was delivered and emit only markets that are new or that actually moved. State lives in a named key-value store, so it survives between runs.", "default": false }, "minProbabilityMove": { "title": "Min probability move", "type": "string", "description": "In monitor mode, ignore moves smaller than this. 0.05 means a market is re-emitted only after the implied probability moves 5 points.", "default": "0" }, "emitUnchanged": { "title": "Emit unchanged rows", "type": "boolean", "description": "Off by default: you should not pay twice for a market that did not move.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Separate memories for separate schedules. Two schedules with different keys do not interfere.", "default": "default" }, "compactOutput": { "title": "Compact output", "type": "boolean", "description": "16 core fields instead of the full row — for LLM context windows and agent pipelines.", "default": false }, "excludeEmptyFields": { "title": "Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-array fields from each row before it is written.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "A run summary with up to 20 markets is POSTed here when the run ends. Slack and Discord incoming webhooks are formatted for them automatically; any other URL gets plain JSON." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }