Kalshi — Prediction Markets

Before writing queries, consult references/api-reference.md for sport codes, series tickers, and command parameters.

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills kalshi search_markets --sport=nba
sports-skills kalshi get_todays_events --sport=nba
sports-skills kalshi get_sports_config
sports-skills kalshi get_markets --series_ticker=KXNBA --status=open

Python SDK (alternative):

from sports_skills import kalshi

kalshi.search_markets(sport='nba')
kalshi.search_markets(sport='nba', query='Lakers')
kalshi.get_todays_events(sport='nba')
kalshi.get_sports_config()
kalshi.get_markets(series_ticker="KXNBA", status="open")

CRITICAL: Before Any Query

CRITICAL: Before calling any market endpoint, verify:

• The sport parameter is always passed to search_markets and get_todays_events for single-game markets.
• Prices are on a 0-100 integer scale (20 = 20% implied probability) — do not treat as American odds.
• status="open" is used when querying markets to exclude settled/closed markets.

Without the sport parameter:

WRONG: search_markets(query="Leeds")           → 0 results
RIGHT: search_markets(sport='epl', query='Leeds') → returns all Leeds markets

Important Notes

• On Kalshi, "Football" = NFL. For football/soccer (EPL, La Liga, etc.), use sport codes: epl, ucl, laliga, bundesliga, seriea, ligue1, mls.
• Prices are probabilities. A last_price of 20 means 20% implied probability. Scale is 0-100 (not 0-1 like Polymarket).
• Always use status="open" when querying markets, otherwise results include settled/closed markets.
• Shared interface with Polymarket: search_markets(sport=...), get_todays_events(sport=...), and get_sports_config() work the same way on both platforms.

Workflows

Sport Market Search (Recommended)

1. search_markets --sport=nba — finds all open NBA markets.
2. Optionally add --query="Lakers" to filter by keyword.
3. Results include yes_bid, no_bid, volume for each market.

Today's Events

1. get_todays_events --sport=nba — open events with nested markets.
2. Present events with prices (price = implied probability, 0-100 scale).

Futures Market Check

1. get_markets --series_ticker=<ticker> --status=open
2. Sort by last_price descending.
3. Present top contenders with probability and volume.

Market Price History

1. Get market ticker from search_markets --sport=nba.
2. get_market_candlesticks --series_ticker=<s> --ticker=<t> --start_ts=<start> --end_ts=<end> --period_interval=60
3. Present OHLC with volume.

Commands

See references/api-reference.md for the full command list with parameters.