Kalshi Prediction Markets & Odds Scraper

Here is one real result, with every field the actor returns:

{
  "marketTicker": "KXNEXTNATOSECGEN-99-KIOH",
  "eventTicker": "KXNEXTNATOSECGEN-99",
  "seriesTicker": "KXNEXTNATOSECGEN",
  "question": "Will Klaus Iohannis be the next Secretary General of NATO?",
  "eventTitle": "Who will be the next Secretary General of NATO?",
  "category": "Elections",
  "yesSubTitle": "Klaus Iohannis",
  "noSubTitle": "Klaus Iohannis",
  "outcomes": ["Yes", "No"],
  "yesProbability": 0.1,
  "yesImpliedPercent": 10,
  "lastPrice": 0.1,
  "yesBid": 0.1,
  "yesAsk": 0.15,
  "noBid": 0.85,
  "noAsk": 0.9,
  "previousPrice": 0.1,
  "volume": 251,
  "volume24h": 0,
  "liquidity": 0,
  "openInterest": 71,
  "notionalValue": 1,
  "marketType": "binary",
  "strikeType": "custom",
  "status": "active",
  "resolved": false,
  "resolvedOutcome": null,
  "openTime": "2026-06-29T19:47:00Z",
  "closeTime": "2099-01-08T15:00:00Z",
  "expirationTime": "2099-01-08T15:00:00Z",
  "canCloseEarly": true,
  "rules": "If Klaus Iohannis formally holds the position of Secretary General of NATO, and is the first such subject to do so after Issuance, then the market resolves to Yes.",
  "eventUrl": "https://kalshi.com/markets/KXNEXTNATOSECGEN-99",
  "source": "Kalshi",
  "observedAt": "2026-08-14T08:21:11.012Z",
  "error": null,
  "aiSummary": "This prediction market is asking whether Klaus Iohannis will become the next Secretary General of NATO ... (AI add-on output, trimmed)",
  "aiResolution": {
    "resolutionSource": null,
    "resolutionCriteria": "If Klaus Iohannis formally holds the position of Secretary General of NATO, and is the first such subject to do so after Issuance",
    "resolutionDate": null,
    "settlementNotes": null
  }
}

The most complete Kalshi prediction markets scraper available. It returns every field Kalshi exposes for each market, including live Yes/No prices, bid/ask, implied probability, volume, liquidity, open interest, resolution rules and timing, and gives you browse and lookup modes with many filters plus optional AI add-ons to target exactly the markets you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor reads Kalshi prediction markets and writes one normalized record per market to the run's dataset. In browse mode it lists markets filtered by status, category, search text, series, volume, liquidity, open interest, Yes-price range and close date. In lookup mode it returns specific markets, events or series by ticker. Each record carries the market identity (tickers, question, event, category), live pricing (yesProbability, yesImpliedPercent, lastPrice, bids and asks), market stats (volume, volume24h, liquidity, openInterest), status and resolution timing, and the plain-text resolution rules. Missing values are returned as null, never invented.

Optional add-ons enrich each record: a plain-English AI market summary and structured AI resolution-terms extraction. Both are off by default and require a paid Apify plan.

Quickstart

Open the actor, paste this into the input, and press Run. It browses up to 40 open markets.

{
  "mode": "browse",
  "status": "open",
  "maxMarkets": 40
}

Add categories, searchText, price or volume filters to narrow the browse. Every input field is optional.

Input reference

Field	Type	Required	Default	Description
mode	enum	no	browse	browse markets with filters, or lookup specific markets/events/series by ticker.
status	enum	no	open	Which markets to return: open, closed, settled, all.
categories	string[]	no	(any)	Keep only markets in these categories (for example Politics, Sports, Economics, World, Crypto). Case-insensitive.
searchText	string	no	(empty)	Keep only markets whose question, event or ticker contains this text.
seriesTickers	string[]	no	(none)	Restrict to one or more Kalshi series tickers (for example KXPRES).
eventTickers	string[]	no	(none)	In lookup mode, return all markets for these event tickers.
marketTickers	string[]	no	(none)	In lookup mode, return these specific market tickers.
minVolume	number	no	(none)	Keep only markets with at least this much traded volume.
minLiquidity	number	no	(none)	Keep only markets with at least this much resting liquidity (dollars).
minOpenInterest	number	no	(none)	Keep only markets with at least this much open interest (outstanding contracts).
minYesPrice	number	no	(none)	Keep only markets whose Yes price (0-1, for example 0.6 = 60% implied) is at least this value.
maxYesPrice	number	no	(none)	Keep only markets whose Yes price (0-1) is at most this value.
closeAfter	string	no	(none)	Keep only markets closing on or after this date (ISO date or unix timestamp).
closeBefore	string	no	(none)	Keep only markets closing on or before this date (ISO date or unix timestamp).
maxMarkets	integer	no	40	Maximum number of market records to collect across the run.
withAiSummary	boolean	no	false	Paid add-on. Write a plain-English explanation of each market. Requires a paid Apify plan. Billed only when produced.
withAiExtract	boolean	no	false	Paid add-on. Extract structured resolution terms (source, criteria, date, caveats) from the rules text. Requires a paid Apify plan. Billed only when produced.

Output reference

One dataset item per market. Types: string, number, integer, boolean, array, object, or null when the source value is absent.

Field	Type	Description
marketTicker	string	Kalshi market ticker, unique per market.
eventTicker	string	Ticker of the event the market belongs to.
seriesTicker	string	Ticker of the series the event belongs to.
question	string	The Yes/No question the market asks.
eventTitle	string	Title of the parent event.
category	string	Market category.
yesSubTitle	string	Yes-side subtitle/label.
noSubTitle	string	No-side subtitle/label.
outcomes	array	Outcome labels (["Yes","No"]).
yesProbability	number	Yes price as a 0-1 probability.
yesImpliedPercent	number	Yes price as an implied percentage.
lastPrice	number	Last traded price (0-1).
yesBid	number	Best Yes bid price.
yesAsk	number	Best Yes ask price.
noBid	number	Best No bid price.
noAsk	number	Best No ask price.
previousPrice	number	Prior price point.
volume	number	Total traded volume.
volume24h	number	Volume in the last 24 hours.
liquidity	number	Resting liquidity in dollars.
openInterest	number	Outstanding contracts.
notionalValue	number	Contract notional value.
marketType	string	Market type (for example binary).
strikeType	string	Strike type (for example custom).
status	string	Market status (for example active).
resolved	boolean	Whether the market has resolved.
resolvedOutcome	string	Resolved outcome, or null if unresolved.
openTime	string	ISO 8601 open time.
closeTime	string	ISO 8601 close time.
expirationTime	string	ISO 8601 expiration time.
canCloseEarly	boolean	Whether the market can close early.
rules	string	Plain-text resolution rules.
eventUrl	string	Public Kalshi event URL.
source	string	Always Kalshi.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.
aiSummary	string	AI plain-English market explanation (paid add-on), else null.
aiResolution	object	AI-extracted resolutionSource, resolutionCriteria, resolutionDate, settlementNotes (paid add-on), else null.

Example output record

Real record from a live run (input {"mode":"browse","status":"open"} with AI add-ons enabled). The aiSummary value is trimmed here for readability; the dataset returns it in full.

{
  "marketTicker": "KXNEXTNATOSECGEN-99-KIOH",
  "eventTicker": "KXNEXTNATOSECGEN-99",
  "seriesTicker": "KXNEXTNATOSECGEN",
  "question": "Will Klaus Iohannis be the next Secretary General of NATO?",
  "eventTitle": "Who will be the next Secretary General of NATO?",
  "category": "Elections",
  "yesSubTitle": "Klaus Iohannis",
  "noSubTitle": "Klaus Iohannis",
  "outcomes": ["Yes", "No"],
  "yesProbability": 0.1,
  "yesImpliedPercent": 10,
  "lastPrice": 0.1,
  "yesBid": 0.1,
  "yesAsk": 0.15,
  "noBid": 0.85,
  "noAsk": 0.9,
  "previousPrice": 0.1,
  "volume": 251,
  "volume24h": 0,
  "liquidity": 0,
  "openInterest": 71,
  "notionalValue": 1,
  "marketType": "binary",
  "strikeType": "custom",
  "status": "active",
  "resolved": false,
  "resolvedOutcome": null,
  "openTime": "2026-06-29T19:47:00Z",
  "closeTime": "2099-01-08T15:00:00Z",
  "expirationTime": "2099-01-08T15:00:00Z",
  "canCloseEarly": true,
  "rules": "If Klaus Iohannis formally holds the position of Secretary General of NATO, and is the first such subject to do so after Issuance, then the market resolves to Yes.",
  "eventUrl": "https://kalshi.com/markets/KXNEXTNATOSECGEN-99",
  "source": "Kalshi",
  "observedAt": "2026-08-14T08:21:11.012Z",
  "error": null,
  "aiSummary": "This prediction market is asking whether Klaus Iohannis will become the next Secretary General of NATO ... (trimmed; full text in dataset)",
  "aiResolution": {
    "resolutionSource": null,
    "resolutionCriteria": "If Klaus Iohannis formally holds the position of Secretary General of NATO, and is the first such subject to do so after Issuance",
    "resolutionDate": null,
    "settlementNotes": null
  }
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~kalshi-markets-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"browse","status":"open","categories":["Politics"],"maxMarkets":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~kalshi-markets-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"lookup","seriesTickers":["KXPRES"],"maxMarkets":200}'

Apify CLI:

apify call scrapers_lat/kalshi-markets-scraper \
  --input '{"mode":"browse","status":"open","searchText":"NATO"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per market record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. The AI add-ons require a paid Apify plan. Upgrade for higher maxMarkets and AI enrichment.

FAQ and troubleshooting

How do I read the odds? yesProbability is the Yes price on a 0-1 scale, which equals the market-implied probability. yesImpliedPercent is the same value as a percentage. Bids and asks show the current order book.

What is the difference between browse and lookup mode? browse lists markets matching your filters. lookup returns specific markets, events or series you name by ticker in marketTickers, eventTickers or seriesTickers.

How do I get only high-probability or contested markets? Use minYesPrice and maxYesPrice (0-1). For example minYesPrice: 0.4, maxYesPrice: 0.6 keeps roughly coin-flip markets.

How do I filter by liquidity or activity? Set minVolume, minLiquidity or minOpenInterest to keep only actively traded markets.

A run returned 0 records. Why? The filter combination matched nothing, or the status excluded them. Loosen the filters or switch status to all. Zero-result runs are not charged.

Are the AI add-ons free? No. withAiSummary and withAiExtract require a paid Apify plan and are billed only when they return usable output. They are off by default.

Is this an official Kalshi tool? No. This actor is independent and has no affiliation with Kalshi. It only accesses publicly available market data and is not trading or financial advice. Use the results in accordance with the source's terms.

Related scrapers

• JustForFans Public Profile Scraper: public creator profiles and stats.
• Jumia Products Scraper: product listings and prices from Jumia.
• Kavak Used Cars Scraper: used-car listings and prices from Kavak.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Kalshi. Accesses only publicly available market data and is not financial advice. Use the results in accordance with the source's terms.