{ "openapi": "3.0.1", "info": { "title": "Prediction Market Scraper - Kalshi + Polymarket", "description": "Kalshi + Polymarket in one schema: live odds, prices, volume, open interest, full order-book depth, settled results for backtesting, and Kalshi candlestick history. Keyless public APIs, no browser. Targets the most actively traded markets by default, and never charges you for empty results.", "version": "0.1", "x-build-id": "cYqpj88Hl0i4EY4a4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oddsmith~prediction-market-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oddsmith-prediction-market-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/oddsmith~prediction-market-scraper/runs": { "post": { "operationId": "runs-sync-oddsmith-prediction-market-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/oddsmith~prediction-market-scraper/run-sync": { "post": { "operationId": "run-sync-oddsmith-prediction-market-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "markets", "orderbook", "settled", "candlesticks" ], "type": "string", "description": "What to pull. 'markets' lists markets; 'orderbook' captures point-in-time depth; 'settled' returns resolved markets with results; 'candlesticks' returns Kalshi OHLC history.", "default": "markets" }, "venues": { "title": "Venues", "type": "array", "description": "Which prediction markets to query.", "items": { "type": "string", "enum": [ "kalshi", "polymarket" ], "enumTitles": [ "Kalshi", "Polymarket" ] }, "default": [ "kalshi", "polymarket" ] }, "status": { "title": "Market status (markets mode)", "enum": [ "open", "closed", "settled" ], "type": "string", "description": "Which markets to return in 'markets' mode: currently tradable (Open), no longer trading but not yet resolved (Closed), or resolved with a known result (Settled).", "default": "open" }, "closeWithinDays": { "title": "Only markets closing within N days (Kalshi discovery)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Restricts Kalshi discovery to markets closing inside this window. This controls SCOPE: a 30-day window exposes about 200 Kalshi markets, a 90-day window about 10,000. Widen it for broader coverage, narrow it for markets resolving soon. Ignored when a series ticker is given. Setting 0 removes the window, but Kalshi's unfiltered listing is dominated by internal shard markets, so leave 'Only markets that trade' on if you do.", "default": 90 }, "onlyTraded": { "title": "Only markets that actually trade", "type": "boolean", "description": "Keep only markets with non-zero volume or open interest. On by default: it is what makes the results useful, and it also filters out the internal shard markets that pad Kalshi's raw listing. Turn off to get the complete listing including untraded markets.", "default": true }, "seriesTicker": { "title": "Kalshi series ticker (optional filter)", "type": "string", "description": "Restrict Kalshi results to one series, e.g. KXBTC, KXHIGHNY, KXMLBGAME. Leave blank for all." }, "tickers": { "title": "Explicit tickers / token ids (orderbook & candlesticks)", "type": "array", "description": "Specific Kalshi tickers or Polymarket CLOB token ids to snapshot. If empty, targets are discovered from open markets.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on markets SCANNED PER VENUE. Delivered results can be fewer, because billing guards drop anything you should not pay for: settled markets with no recorded outcome, order books with no levels, candlestick windows with no trades. You are never charged for those. With both venues selected the default scans up to 1,000 each.", "default": 1000 }, "orderbookDepth": { "title": "Order book depth (Kalshi)", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many price levels to capture per side of the Kalshi order book. Higher values give deeper liquidity detail per snapshot.", "default": 10 }, "startTs": { "title": "Candlestick start (unix seconds)", "type": "integer", "description": "Start of the candlestick window, as a Unix timestamp in seconds. Defaults to 24 hours before the run." }, "endTs": { "title": "Candlestick end (unix seconds)", "type": "integer", "description": "End of the candlestick window, as a Unix timestamp in seconds. Defaults to the run start time." }, "periodInterval": { "title": "Candlestick period (minutes)", "type": "integer", "description": "Candle size in minutes (for example 1, 60, or 1440 for daily). Applies to candlesticks mode only.", "default": 60 } } }, "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 } } } } } } } } } }