datagrit › Data › Kalshi Settlement Calendar & Order Book Depth

Kalshi Settlement Calendar & Order Book Depth

Kalshi markets ranked by when they settle, with the order book depth, spread and settlement source of each one.

It lists the open Kalshi prediction markets that are expected to settle inside a time window you choose, for example the next 24 hours, and returns one flat row per market: expected settlement time, hours to settle, the sources Kalshi settles on, YES bid, ask and spread, 24-hour volume, open interest and the contracts resting near the best bid and ask. It is built for traders, quants and bot builders who want a settlement calendar with liquidity attached, not a dump of every market. Export the rows as JSON, CSV or Excel, call the Actor through the Apify API, or plug it into n8n, Make and AI agents through MCP.

What can you use the Kalshi settlement calendar for?

• Settlement-day trading. See every market that settles tonight or this week, sorted by the soonest expected settlement, and skip the ones nobody quotes.
• Liquidity screening. Filter by minimum 24h volume, minimum open interest and maximum spread in cents, then check how many contracts sit within a few cents of the best bid and ask before you size an order.
• Resolution-source research. Every row carries the settlement sources of its series, with links, so you can group markets by the data feed that decides them.
• Alerts and dashboards. Schedule the Actor every hour and feed a spreadsheet, a Slack bot or a trading script with the next markets to settle.
• Overdue markets. Set the lower bound of the window below zero to also list markets whose expected settlement time has passed but which have not settled yet.

How to use the Kalshi order book and settlement filters

1. Set Settles within (hours) to the horizon you care about. The default is 24.
2. Optionally narrow the scope by category (Sports, Crypto, Financials, Politics, Economics, Transportation and others; a series Kalshi lists under several categories is kept when any of them matches), by series ticker or by words in the market title. Naming series is much faster than scanning the whole exchange.
3. Add liquidity filters: minimum 24h volume, minimum open interest, maximum spread. By default only markets quoted on both sides are listed.
4. Choose how to sort and how many markets to return, then run.

Order book depth

When Include order book depth is on, the Actor reads the order book of every returned market. yesBidDepth is the number of contracts resting within the depth window below the best YES bid, and yesAskDepth is the number of contracts you can buy within the window above the best YES ask. The window width is set in cents. The levels and totals cover the whole book. Turn the option off for a faster run without depth.

Output fields

Each row contains the identifiers (ticker, eventTicker, seriesTicker), the series description (seriesTitle, category, categories, frequency; categories lists every category the series is listed under, the same membership the category filter uses), title and outcome, the timing fields (expectedSettlementTime, hoursToSettle, closeTime, latestSettlementTime, settlementTimerSeconds, canCloseEarly), the settlement sources and their URLs, the quotes (yesBid, yesAsk, noBid, noAsk, lastPrice, midPrice, spreadCents, sizes), the activity fields (volume, volume24h, openInterest), the depth fields, optional rules text, sourceUrl and scrapedAt. Fields the source does not publish are null. When no market matches you get one row with found: false, and the run status says why: the series has no open markets right now, nothing settles inside the window, the liquidity and keyword filters removed every market in the window, or Kalshi returned only combination or not-open markets. A source that stops applying its own filters (combination markets or markets that are not active in more than 1% of the scan) fails the run instead of returning rows.

Output fields

Every result is one flat record, so it drops straight into a spreadsheet, a database or a CRM.

Sample record

{
  "found": true,
  "ticker": "KXBTCD-26OCT0117-T83249.99",
  "eventTicker": "KXBTCD-26OCT0117",
  "seriesTicker": "KXBTCD",
  "seriesTitle": "Bitcoin price Above/below",
  "category": "Crypto",
  "categories": [
    "Economics",
    "Transportation"
  ],
  "frequency": "hourly",
  "title": "Bitcoin price on Oct 1, 2026?",
  "outcome": "Dallas",
  "status": "active",
  "expectedSettlementTime": "2026-10-01T10:00:00.000Z",
  "hoursToSettle": 18.34,
  "closeTime": "2026-10-03T01:00:00.000Z",
  "latestSettlementTime": "2026-10-03T01:00:00.000Z",
  "settlementTimerSeconds": 90,
  "canCloseEarly": true,
  "settlementSources": "CF Benchmarks",
  "settlementSourceUrls": "https://www.cfbenchmarks.com/data/indices/BRTI",
  "yesBid": 0.58,
  "yesAsk": 0.59,
  "noBid": 0.41,
  "noAsk": 0.42,
  "lastPrice": 0.58,
  "midPrice": 0.585,
  "spreadCents": 1,
  "yesBidSize": 7442.21,
  "yesAskSize": 525.33,
  "volume": 29185.23,
  "volume24h": 29185.23,
  "openInterest": 17101.47,
  "yesBidDepth": 16839.01,
  "yesAskDepth": 19022.45,
  "yesBidLevels": 31,
  "yesAskLevels": 59,
  "yesBidTotal": 101444.2,
  "yesAskTotal": 150167.1,
  "depthWindowCents": 5,
  "rulesPrimary": "If Bitcoin is above 83249.99 at 5pm EDT, the market resolves to Yes.",
  "rulesSecondary": "If the source is unavailable, the market settles on the next published value.",
  "sourceUrl": "https://api.elections.kalshi.com/trade-api/v2/markets/KXBTCD-26OCT0117-T83249.99",
  "scrapedAt": "2026-10-01T02:44:42.436Z"
}

Input

Call it from your code

Run the Actor and get the results in one request. Replace YOUR_APIFY_TOKEN with the token from your Apify account settings.

curl -X POST "https://api.apify.com/v2/acts/datagrit~kalshi-settlement-calendar/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"settlesWithinHours":48,"maxItems":50}'

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('datagrit/kalshi-settlement-calendar').call({
  "settlesWithinHours": 48,
  "maxItems": 50
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("datagrit/kalshi-settlement-calendar").call(run_input={
  "settlesWithinHours": 48,
  "maxItems": 50
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(len(items), items[0] if items else None)

Related Actors