Kalshi Event Market Data — Contracts API

Keyless. Pay per record. Structured event-contract market data.

This actor turns Kalshi's public event-contract markets into clean, per-market records — the raw market-data layer for the regulated event exchange. Each run reads Kalshi's keyless public API and delivers one row per market: the ticker, the event and category, the yes/no bid-ask prices, the last price, the volume and open interest, the status, and the close/expiration times. Market grain, structured for engineering use, with informational-only disclaimers on every record.

What this is, in one paragraph

Kalshi runs a regulated exchange of binary event contracts — markets that pay out on real-world outcomes across politics, economics, weather, world events, and more. This actor reads Kalshi's public events API (with nested markets), so each event's category and title travel with every market, and flattens each market into a single analysis-ready record: identity, prices, size, status, and timing. Values are as served by Kalshi's public API. You are billed only for records actually delivered.

Who buys this and for what job

• Quant and research teams ingesting a structured, per-market snapshot of Kalshi event contracts for models and back-tests.
• Data engineers and app builders who want the market-data layer as clean rows keyed by ticker and category, without writing a Kalshi client.
• Dashboards and analytics products displaying event-contract prices, volume, and open interest by category.
• Researchers studying event-market pricing across categories over time.

Informational data — no advice, not real-time

Three honesty riders travel on every record. This is informational market data only — not trading, investment, or financial advice, and not an offer or solicitation to trade. It is not a real-time feed: prices, volume, and open interest are as served by Kalshi's public API and may be delayed. And reuse is governed by Kalshi's own terms: the data is Kalshi Exchange market data, © Kalshi, provided "as is"; Kalshi's Developer Agreement and terms govern any downstream use — verify on kalshi.com before acting.

Market grain — no person data

This actor works at market grain: tickers, prices, sizes, and outcomes. There are no natural-person fields in this data, and this actor emits none, with a person-key guard on every record as a backstop.

Pricing

Event	Free plan	Bronze	Silver	Gold / Platinum / Diamond
market_record	$0.05	$0.045	$0.04	$0.0335

Delivered before charged. Blocked runs and empty results cost nothing.

Input

Field	Type	Default	Description
category	string	—	Optional. Keep only events in this Kalshi category (e.g. Politics, Economics, World, Sports).
statusFilter	string	—	Optional. Keep only markets with this status (e.g. active, settled). Applied to delivered records.
maxRecords	integer	500	Ceiling on records delivered and billed.

Output

One JSON object per market. Real example (values as served):

{
  "record_id": "KXELONMARS-99",
  "ticker": "KXELONMARS-99",
  "event_ticker": "KXELONMARS-99",
  "series_ticker": "KXELONMARS",
  "market_title": "Will Elon Musk visit Mars before Aug 1, 2099?",
  "event_title": "Will Elon Musk visit Mars in his lifetime?",
  "category": "World",
  "status": "active",
  "market_type": "binary",
  "yes_bid": 0.10,
  "yes_ask": 0.12,
  "no_bid": 0.88,
  "no_ask": 0.90,
  "last_price": 0.10,
  "volume": 117303.13,
  "volume_24h": 59.48,
  "open_interest": 40101.16,
  "open_time": "2025-08-28T20:45:00Z",
  "close_time": "2099-08-01T04:59:00Z",
  "source": "Kalshi (event-contract market data)",
  "source_url": "https://kalshi.com/markets/KXELONMARS",
  "licence": "Kalshi Exchange event-contract market data, © Kalshi ... terms govern any reuse.",
  "attribution": "Data from Kalshi (kalshi.com).",
  "disclaimer": "Informational market data only — NOT trading, investment, or financial advice ... not a real-time feed ...",
  "observed_at": "2026-08-21T00:00:00Z"
}

An unbilled RUN_RECEIPT records the robots check, the filters, markets seen and delivered, whether charged equals delivered, and the informational/not-real-time notice.

Field reference

Each record is one market. Identity: record_id / ticker, event_ticker, series_ticker, market_title, event_title, and category. State: status, result (once settled), and market_type. Prices (dollars): yes_bid, yes_ask, no_bid, no_ask, last_price, and notional_value. Size: volume, volume_24h, open_interest, and liquidity. Timing: open_time, close_time, and expiration_time. Provenance and caveats: source, source_url, licence, attribution, disclaimer, and observed_at.

How a run works

A run first re-reads the source's robots posture from your runtime — the API host serves no robots file, a no-policy posture — and stops at the door if that ever changes. It then reads Kalshi's events endpoint with nested markets, page by page via the API's cursor, so each event's category and title are attached to every market it contains. Each market is flattened to one record, prices and sizes parsed to numbers, and delivered before it is charged, so a blocked or empty run costs you nothing. Your optional category and status filters are applied per record before delivery, so you are billed only for markets that pass them. The actor paces between pages, stops at your maxRecords ceiling, and records charge_equals_delivered in the receipt.

Categories you can pull

Kalshi organizes its markets into events, and each event carries a category — this actor surfaces that category on every market row so a mixed pull stays self-describing and easy to pivot. Categories span the exchange's full breadth: Politics and Elections, Economics (rates, inflation, jobs prints), World events, Climate and Weather, Science and Technology, Sports, and more. Because the category comes from the parent event and is attached to each nested market, you can pass a single category to build a focused feed — say, only economics markets, or only weather markets — or pull across all of them and group by category downstream. Paired with statusFilter, you can narrow further to just the active markets (a live snapshot) or just the settled ones (an outcome history), which is the difference between a monitoring feed and a research archive.

Cost guidance

One market_record per delivered market: cost = markets delivered × your plan's per-record price. Kalshi lists thousands of events, each with one or more markets, so scope with category and statusFilter to keep runs bounded — a single category's active markets is typically a few hundred. 1,000 markets is $50 (Free) / $33.50 (Gold).

Honest limitations

• Not real-time. Data is as served by Kalshi's public API and may be delayed; this is a snapshot feed, not a live tick stream.
• Informational only. Nothing here is trading, investment, or financial advice, or an offer to trade.
• Kalshi's terms govern reuse. The data is Kalshi's; downstream use is subject to Kalshi's Developer Agreement and terms.
• Market grain. This is the market-data record — not order books, trade history, or account data.
• No person data is emitted.

Differentiation

The NexGenData fleet already ships kalshi-prediction-markets-tracker, which is built around the odds / implied-probability / volume-tracking angle for people watching prediction-market movements. This actor is the market-data / event-contracts API angle: a clean, per-market structured feed keyed by ticker and category for engineers and analysts who want the data layer rather than a probability tracker. Same source, different job — the two catch different buyer searches, and the sibling is named here so buyers pick the right one.

The NexGen Signal family

Part of the NexGen Signal family of pay-per-record data products:

• National Macro Indicator Records — World Bank
• ECB Bank Interest Rate Records — Euro Area MFI
• US Treasury Fiscal Records — Rates & Debt
• Federal Rulemaking Records — US Federal Register
• Organization Sanctions & LEI Risk

Source: Kalshi public event-contract market API. Kalshi Exchange market data, © Kalshi, provided "as is"; informational use only, not trading advice, not a real-time feed; Kalshi's Developer Agreement and terms govern any reuse. Reformatted to market records; no person data emitted.