Kalshi — Prediction Markets

Setup

which sports-skills || pip install sports-skills

pip install

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills

Quick Start

sports-skills kalshi get_markets --series_ticker=KXNBA
sports-skills kalshi get_events --series_ticker=KXNBA --status=open

from sports_skills import kalshi

markets = kalshi.get_markets(series_ticker="KXNBA")
event = kalshi.get_event(event_ticker="KXNBA-26FEB14")

Commands

get_exchange_status

get_exchange_schedule

get_series_list

• category

  (str, optional): Filter by category

• tags

  (str, optional): Filter by tags

get_series

• series_ticker

  (str, required): Series ticker (see table below)

get_events

• limit

  (int, optional): Max results (default: 100, max: 200)

• cursor

  (str, optional): Pagination cursor

• status

  (str, optional): Filter by status ("open", "closed", "settled")

• series_ticker

  (str, optional): Filter by series ticker

• with_nested_markets

  (bool, optional): Include nested markets

get_event

• event_ticker

  (str, required): Event ticker

• with_nested_markets

  (bool, optional): Include nested markets

get_markets

• limit

  (int, optional): Max results (default: 100)

• cursor

  (str, optional): Pagination cursor

• event_ticker

  (str, optional): Filter by event

• series_ticker

  (str, optional): Filter by series

• status

  (str, optional): Filter ("unopened", "open", "closed", "settled")

• tickers

  (str, optional): Comma-separated market tickers

get_market

• ticker

  (str, required): Market ticker

get_trades

• limit

  (int, optional): Max results (default: 100, max: 1000)

• cursor

  (str, optional): Pagination cursor

• ticker

  (str, optional): Filter by market ticker

• min_ts

  (int, optional): After Unix timestamp

• max_ts

  (int, optional): Before Unix timestamp

get_market_candlesticks

• series_ticker

  (str, required): Series ticker

• ticker

  (str, required): Market ticker

• start_ts

  (int, required): Start Unix timestamp

• end_ts

  (int, required): End Unix timestamp

• period_interval

  (int, required): Interval in minutes (1, 60, or 1440)

get_sports_filters

Common Series Tickers

KXNBA

KXNFL

KXMLB

KXUCL

KXLALIGA

KXBUNDESLIGA

KXSERIEA

KXLIGUE1

KXFACUP

KXUEL

KXUECL

get_sports_filters()

Examples

1. Call

   get_events(series_ticker="KXNBA", status="open", with_nested_markets=True)

2. Present events with their nested markets, yes/no prices, and volume

1. Call

   get_markets(series_ticker="KXUCL", status="open")

2. Sort by

   last_price

   descending — price = implied probability (e.g., 20 = 20%)
3. Present top teams with

   yes_sub_title

   ,

   last_price

   , and

   volume

1. Get the market ticker from

   get_markets(series_ticker="KXNBA")

2. Call

   get_market_candlesticks(series_ticker="KXNBA", ticker="...", start_ts=..., end_ts=..., period_interval=60)

3. Present OHLC data with volume

Troubleshooting

• sports-skills

  command not found: Package not installed. Run

  pip install sports-skills

  . If pip fails with a Python version error, you need Python 3.10+ — see Setup section.

• ModuleNotFoundError: No module named 'sports_skills'

  : Same as above — install the package. Prefer the CLI over Python imports to avoid path issues.
• Empty market results: Use

  status="open"

  to filter for active markets. Default returns all statuses including settled/closed.
• Series ticker unknown: Check the Common Series Tickers table above. Use

  get_sports_filters()

  to discover categories, but note: "Football" = NFL, "Soccer" = football/soccer. Not all soccer leagues have futures markets.
• "Football" returned NFL, not soccer: Kalshi categorizes American Football as "Football" and soccer as "Soccer". Use

  KXUCL

  ,

  KXLALIGA

  , etc. for soccer — see tickers table.
• Pagination: Default limit is 100. If results are truncated, use the

  cursor

  value from the response to fetch the next page.
• Candlestick timestamps:

  start_ts

  and

  end_ts

  must be Unix timestamps (seconds).

  period_interval

  is in minutes: 1 (1-min), 60 (1-hour), or 1440 (1-day).

API

• Base URL:

  https://api.elections.kalshi.com/trade-api/v2

• All endpoints are public, read-only. No authentication required.