# Kalshi Scraper | Fast & Reliable (`fatihtahta/kalshi-scraper`) Actor Get live prediction market data from Kalshi.com with tickers, categories, prices, and volume metrics. Fast, reliable, and structured for analysis. Ideal for traders, researchers, and data teams. - **URL**: https://apify.com/fatihtahta/kalshi-scraper.md - **Developed by:** [Fatih Tahta](https://apify.com/fatihtahta) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 34 total users, 2 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $0.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Kalshi Scraper | Fast & Reliable | $4 / 1k **Slug:** `fatihtahta/kalshi-scraper` **Price:** **$4.00 per 1,000 saved markets or events** Stay ahead of every major U.S. political and economic market listed on **Kalshi**. This actor transforms Kalshi search results and individual market listings into structured datasets that are perfect for forecasting, market monitoring, or alerting workflows. Point it at a search query or specific market URL and let the run deliver clean, analysis-ready data. --- ### 💡 Why choose this actor? - **Monitor market sentiment in seconds** – Capture the latest markets across any query (e.g., _“presidential election”_, _“inflation”_). - **Drill into specific contracts** – Provide direct Kalshi market URLs to pull the full listing context, including pricing snapshots and metadata. - **Reliable at scale** – Built to handle high-volume runs with automatic pagination and result caps so you only pay for what you need. - **Flexible exports** – Download your dataset in JSON, CSV, Excel, or connect via API for programmatic updates. > Ideal for: **traders, analysts, researchers, political consultants, and quant teams** who rely on Kalshi data for decision-making. --- ### 🧠 What data do you get? Each saved item represents either a **market series** (from search) or a **specific contract listing** (from a market URL). Typical fields include: - `query` – Search phrase that surfaced the series. - `sourceUrl` – The Kalshi API endpoint used for the result. - `ticker`, `series_ticker`, `event_ticker` – Identifiers you can map back to Kalshi. - `title`, `subtitle`, `description` – Human-readable market copy. - `categories`, `tags`, `market_type`, `status` – Classification and lifecycle hints. - `yes_price`, `no_price`, `last_trade_price`, `volume` – Key pricing and liquidity metrics (when available). - `settlement_timing`, `resolution_source`, `rules` – Details on how the contract resolves. - `listingUrl` – Original market URL (for listing runs). - Timestamps such as `created_at`, `last_traded_at`, `close_date`, and more depending on the market. > Outputs are normalized and deduplicated so you can sort, filter, or pivot immediately. --- ### 📥 Input configuration Configure the actor from the **Input** tab. Key fields: - `searchQueries` _(array of strings, optional)_ — Keywords to search on Kalshi. Multiple queries run independently. - `startUrls` _(array of strings, optional)_ — Kalshi URLs to process. Supports search URLs (`?search=`) and individual market listings. - `targetUrl` _(string, optional)_ — Single Kalshi URL, handy for quick one-off pulls. - `targetUrls` _(array of strings, optional)_ — Alias of `startUrls` for convenience. - `maxResults` _(number, default `200`)_ — Maximum markets to save per query (minimum 1). - `pageSize` _(number, default `min(maxResults, 50)`)_ — Items fetched per API call (capped between 1 and 100). - `proxyConfiguration` _(object, optional)_ — Use Apify Proxy or bring your own. > Tip: Provide at least one `searchQueries` entry or Kalshi URL. If you’re unsure, start with a small `maxResults` (e.g., `50`) to validate output. --- ### 🧪 Example input ```json { "searchQueries": ["new york", "inflation"], "startUrls": ["https://kalshi.com/markets/kxmayornycparty/mayor-of-nyc-party-winner/kxmayornycparty-25"], "maxResults": 50, "pageSize": 25, "proxyConfiguration": { "useApifyProxy": true } } ```` *** ### 📦 Sample output ```json { "query": "new york", "sourceUrl": "https://api.elections.kalshi.com/v1/search/series", "type": "contract", "series_ticker": "GOVPARTYNY", "series_title": "New York Governor", "event_ticker": "GOVPARTYNY-26", "event_title": "New York Governor winner?", "category": "Elections", "total_volume": 295509, "active_market_count": 2, "markets": [ { "ticker": "GOVPARTYNY-26-D", "yes_subtitle": "Democratic party", "yes_bid": 89, "yes_ask": 90, "last_price": 89, "volume": 223875 } ], "tags": ["US Elections", "Governor"] } ``` All runs save items into the default **Dataset**. Download as JSON, CSV, Excel, or connect through the Apify API. *** ### 🚀 How to run 1. Open **Kalshi Scraper | Fast & Reliable | $4 / 1k** on Apify. 2. Add your **search queries** and/or **Kalshi URLs** in the Input tab. 3. Set `maxResults` (and `pageSize` if needed). 4. Click **Start** and wait for the run to finish. 5. View results in the **Dataset** tab and download in your preferred format. *** ### 💸 Pricing - **$4.00 per 1,000 saved items** (series or event records). - Billing is based solely on successful dataset entries. *** ### ⚖️ Responsible use The scraper consolidates information that Kalshi publishes publicly. Depending on your jurisdiction and use case, this data may be considered financial market information. Always comply with Kalshi’s terms, applicable securities regulations, and any licensing requirements. Use results ethically and within legal bounds. *** ### ❓ Support & custom work Need help, feature tweaks, or custom dashboards? Open an issue on the actor page in Apify Console—support is available around the clock. Happy market watching!\ **Fatih** # Actor input Schema ## `startUrls` (type: `array`): Paste any Kalshi market or search result URLs that you want the actor to visit. ## `targetUrl` (type: `string`): Paste one Kalshi search or market URL for a quick run. ## `targetUrls` (type: `array`): Optional alias for startUrls. Paste more Kalshi search or market URLs here. ## `searchQueries` (type: `array`): List the keywords you want to search for. ## `maxResults` (type: `integer`): Limit how many market listings the actor should collect before stopping. ## `pageSize` (type: `integer`): How many search results to fetch per API call. The actor caps this between 1 and 100. ## `proxyConfiguration` (type: `object`): By default it uses Apify Residential proxies. ## Actor input object example ```json { "maxResults": 200, "pageSize": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("fatihtahta/kalshi-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("fatihtahta/kalshi-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call fatihtahta/kalshi-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fatihtahta/kalshi-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kalshi Scraper | Fast & Reliable", "description": "Get live prediction market data from Kalshi.com with tickers, categories, prices, and volume metrics. Fast, reliable, and structured for analysis. Ideal for traders, researchers, and data teams.", "version": "1.0", "x-build-id": "BKR4XaGagyBY4e9AS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~kalshi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~kalshi-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~kalshi-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": { "startUrls": { "title": "Search results URLs (Search page or individual market page)", "type": "array", "description": "Paste any Kalshi market or search result URLs that you want the actor to visit.", "items": { "type": "string" } }, "targetUrl": { "title": "Single Kalshi URL", "type": "string", "description": "Paste one Kalshi search or market URL for a quick run." }, "targetUrls": { "title": "Additional Kalshi URLs", "type": "array", "description": "Optional alias for startUrls. Paste more Kalshi search or market URLs here.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "List the keywords you want to search for.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum listings", "minimum": 1, "type": "integer", "description": "Limit how many market listings the actor should collect before stopping.", "default": 200 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many search results to fetch per API call. The actor caps this between 1 and 100.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "By default it uses Apify Residential proxies.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```