{ "openapi": "3.0.1", "info": { "title": "Kalshi Trades API: Whale Trades, Odds & Order Books", "description": "Every Kalshi trade with the market question attached: side, price, contracts and dollars paid. Filter whale trades by size, series (Fed, CPI, weather, sports) or category. Also markets with odds, volume and open interest, order books and price history. Official API, no key.", "version": "1.0", "x-build-id": "gXkt2xgwlzbVn9RNl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~kalshi-trades-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-kalshi-trades-api", "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/wellbuilt_zythem~kalshi-trades-api/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-kalshi-trades-api", "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/wellbuilt_zythem~kalshi-trades-api/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-kalshi-trades-api", "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": { "mode": { "title": "What to get", "enum": [ "trades", "markets", "orderbook", "history" ], "type": "string", "description": "Trades: every trade as it prints, with side, price, contracts, dollars paid and the market's question. Markets: odds, volume and open interest. Order books: every price level. Price history: candles per minute, hour or day.", "default": "trades" }, "minTradeUsd": { "title": "Minimum trade size ($)", "minimum": 0, "type": "integer", "description": "Trades mode. Only trades where the buyer paid at least this much (contracts x price). In one measured hour (29 Oct 2026) Kalshi printed 467,931 trades and 59 of them were $10,000 or more. 0 keeps every trade.", "default": 1000 }, "maxPriceCents": { "title": "Maximum price (cents)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Trades mode. Skip trades that paid more than this per contract. In a measured hour, 39 % of the trades of $1,000 or more paid 95 cents or more: someone buying an outcome that is already decided, for a few dollars of profit. 95 by default; 100 keeps every trade.", "default": 95 }, "lookbackHours": { "title": "Lookback (hours)", "minimum": 1, "maximum": 2160, "type": "integer", "description": "Trades mode: hours back from now. With Series, Event or Market tickers the actor asks Kalshi market by market: 30 days of the Fed series (247 markets) took 76 seconds. Without them it reads the whole exchange, about 2.5 minutes per hour of trades. Up to 2160 (90 days).", "default": 1 }, "startDate": { "title": "Start date (optional)", "type": "string", "description": "Trades mode. UTC date like 2026-10-28 or time like 2026-10-28T14:00:00Z. Overrides Lookback. Older trades are read from Kalshi's historical archive automatically." }, "endDate": { "title": "End date (optional)", "type": "string", "description": "Trades mode. Defaults to now. A date without a time includes that whole day." }, "seriesTickers": { "title": "Series tickers", "type": "array", "description": "Kalshi series, for example KXFED (Fed rate), KXCPI (inflation), KXHIGHNY (New York high temperature). The series is the first part of any market ticker.", "items": { "type": "string" } }, "eventTickers": { "title": "Event tickers", "type": "array", "description": "Kalshi events, for example KXFED-26DEC (the December 2026 Fed meeting).", "items": { "type": "string" } }, "marketTickers": { "title": "Market tickers", "type": "array", "description": "Exact markets, for example KXFED-26DEC-T4.50. In Trades mode Kalshi filters these on its side, so months of trades come back quickly.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Kalshi categories: Politics, Elections, Economics, Financials, Sports, Crypto, Climate and Weather, Entertainment, Companies, Science and Technology, Mentions, Commodities, Health, World.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Only markets whose question or outcome contains this text, for example fed, bitcoin or lakers." }, "includeCombos": { "title": "Include combo contracts (parlays)", "type": "boolean", "description": "Kalshi's multi-leg combo contracts. Off by default: they were 13.5 % of a measured sample of 150,000 trades, and each one mixes several unrelated events.", "default": false }, "status": { "title": "Market status", "enum": [ "open", "closed", "settled" ], "type": "string", "description": "Markets, Order books and Price history modes. Closed and settled markets need Series or Event tickers.", "default": "open" }, "minVolume24h": { "title": "Minimum 24 h volume (contracts)", "minimum": 0, "type": "integer", "description": "Markets modes: drop markets with fewer contracts traded in the last 24 hours. Kalshi listed 155,167 open markets on 29 Oct 2026 and most are empty.", "default": 0 }, "minOpenInterest": { "title": "Minimum open interest (contracts)", "minimum": 0, "type": "integer", "description": "Markets modes: drop markets with fewer contracts still open.", "default": 0 }, "maxMarkets": { "title": "Markets for order books and history", "minimum": 1, "type": "integer", "description": "Order books and Price history modes, when no Market tickers are given: the most traded markets of the last 24 hours that match the filters.", "default": 10 }, "orderbookDepth": { "title": "Order book depth", "minimum": 1, "maximum": 100, "type": "integer", "description": "Price levels kept per side. Totals per side always count the whole book.", "default": 10 }, "historyInterval": { "title": "Candle size", "enum": [ "minute", "hour", "day" ], "type": "string", "description": "Price history mode. Kalshi only returns candles for periods with activity.", "default": "hour" }, "historyDays": { "title": "History window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Price history mode: days back from now.", "default": 7 }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Rows delivered per run. Trades come newest first; markets come most traded first.", "default": 1000 } } }, "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 } } } } } } } } } }