Kalshi — Prediction Markets

Before writing queries, consult

references/api-reference.md

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

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

get_sports_config

get_todays_events

search_markets

get_markets

get_event

get_market

get_trades

get_market_candlesticks

Examples

Example 1: NBA market search User says: "What NBA markets are on Kalshi?" Actions:

1. Call

   search_markets(sport='nba')

   Result: All open NBA markets with yes/no prices and volume

Example 2: EPL game markets User says: "Show me Leeds vs Man City odds on Kalshi" Actions:

1. Call

   search_markets(sport='epl', query='Leeds')

   Result: Leeds EPL markets across all EPL series with prices and volume

Example 3: Today's EPL events User says: "What EPL games are available on Kalshi?" Actions:

1. Call

   get_todays_events(sport='epl')

   Result: Today's EPL events with nested markets

Example 4: Champions League futures User says: "Who will win the Champions League?" Actions:

1. Call

   search_markets(sport='ucl')

   or

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

2. Sort by

   last_price

   descending (price = implied probability) Result: Top UCL contenders with

   yes_sub_title

   ,

   last_price

   (%), and volume

Example 5: Market price history User says: "Show me the price history for this NBA game" Actions:

1. Get market ticker from

   search_markets(sport='nba')

2. Call

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

   Result: OHLC price data with volume

Commands that DO NOT exist — never call these

• get_odds

  — does not exist. Use

  search_markets

  or

  get_markets

  to find market prices.

• get_team_schedule

  — does not exist. Kalshi has markets, not schedules. Use the sport-specific skill for schedules.

• get_scores

  /

  get_results

  — does not exist. Kalshi is a prediction market. Use the sport-specific skill.

If a command is not listed in

references/api-reference.md

Troubleshooting

Error:

search_markets

sport

sport='<code>'

search_markets

references/api-reference.md

Error: Markets returned include settled/expired contracts Cause:

status

status="open"

Error: Series ticker returns no results Cause: The series ticker may be incorrect or have no open markets Solution: Call

get_series_list()

references/series-tickers.md

Error: Football/soccer markets not found when searching "Football" Cause: On Kalshi, "Football" refers to NFL — soccer uses league-specific codes Solution: Use

sport='epl'

sport='ucl'

sport='laliga'