{
"openapi": "3.0.1",
"info": {
"title": "Kalshi Scraper ยท Event Contracts, Markets, Prices & Volume",
"description": "Scrape Kalshi prediction markets, event contracts, option pricing, order book quotes, trading volume, open interest, and resolution rules. Export structured JSON, CSV, or Excel data.",
"version": "1.0",
"x-build-id": "BWCvBGco5bfk6gzo3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~kalshi-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-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/reapx~kalshi-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-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/reapx~kalshi-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-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": {
"category": {
"title": "Market Category Filter",
"enum": [
"",
"Climate and Weather",
"Commodities",
"Companies",
"Crypto",
"Economics",
"Education",
"Elections",
"Entertainment",
"Financials",
"Health",
"Mentions",
"Politics",
"Science and Technology",
"Social",
"Sports",
"Transportation",
"World"
],
"type": "string",
"description": "Filter Kalshi prediction markets by market category topic (e.g. Financials, Elections, Economics, Politics, Sports, Crypto).
Empty value: Leave empty to extract prediction markets across all domain categories.
Consequence: Selecting a category restricts extraction focus, reducing total execution duration and compute consumption."
},
"status": {
"title": "Market Trading Status Filter",
"enum": [
"",
"open",
"closed",
"settled",
"unopened"
],
"type": "string",
"description": "Filter contracts by lifecycle status, using the exchange's own filter vocabulary: open, closed, settled, unopened.
Empty value: leave empty to include contracts at any stage of life.
Consequence: the value you FILTER on and the value that comes BACK on the row are different vocabularies - a contract accepted by status=open is written to the dataset as active, and a brand new one as initialized. Filter with these four; read status on the row for what the exchange actually calls it."
},
"seriesTicker": {
"title": "Series Ticker Filter",
"pattern": "^[A-Za-z0-9_-]*$",
"type": "string",
"description": "Filter prediction markets by specific Kalshi Series Ticker code (e.g. KXFED, KXNFLWINS, KXELONMARS, KXTSLAA).
Empty value: Leave empty to include contracts from all active market series.
Consequence: Specifying a series ticker isolates a single event series, resulting in faster runs and targeted dataset results."
},
"eventTicker": {
"title": "Event Ticker Filter",
"pattern": "^[A-Za-z0-9_.-]*$",
"type": "string",
"description": "Return every contract belonging to one Kalshi event (e.g. KXFEDDECISION-26SEP). An event is the question; each contract under it is one outcome or strike, so this is how you get a whole ladder in one run.
Empty value: leave empty to search by category, series or status instead.
Consequence: the narrowest filter the exchange offers - a single event returns a handful of rows in one request, measured at 5 rows for the September Fed decision ladder."
},
"tickers": {
"title": "Comma-Separated Market Tickers",
"pattern": "^[A-Za-z0-9_,-]*$",
"type": "string",
"description": "Extract specific prediction market tickers by exact ticker identifier code (e.g. KXFED-24DEC31-T1.5).
Empty value: Leave empty to perform broader category or status searches.
Consequence: Providing exact market tickers directly fetches matching contract records without pagination overhead."
},
"minCloseTs": {
"title": "Minimum Close Timestamp (Unix)",
"type": "integer",
"description": "Filter markets closing on or after this Unix epoch timestamp in seconds (e.g. 1767225600 for Jan 1, 2026).
Empty value: Leave empty for no lower bound on market close date.
Consequence: Setting a minimum close timestamp filters out older or past-closing prediction contracts."
},
"maxCloseTs": {
"title": "Maximum Close Timestamp (Unix)",
"type": "integer",
"description": "Filter markets closing on or before this Unix epoch timestamp in seconds (e.g. 1798761600 for Jan 1, 2027).
Empty value: Leave empty for no upper bound on market close date.
Consequence: Setting a maximum close timestamp restricts extraction to near-term or specific timeframe contracts.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"maxMarkets": {
"title": "Maximum Markets Limit",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of Kalshi prediction market contract records to scrape and output.
Default: 200.
Consequence: Higher capacity limits extract larger datasets but increase execution duration and total event costs.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned.",
"default": 200
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}