Kalshi

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, worldcup.
• 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.

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, it does not exist.

Troubleshooting

Error: search_markets returns 0 results Cause: The sport parameter is missing — without it, search only returns high-volume futures and misses single-game markets Solution: Always pass sport='<code>' to search_markets. Check references/api-reference.md for valid sport codes

Error: Markets returned include settled/expired contracts Cause: status parameter is not set Solution: Always pass status="open" to filter to open markets only

Error: Series ticker returns no results Cause: The series ticker may be incorrect or have no open markets Solution: Call get_series_list() to discover available tickers, or check 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', etc. for soccer leagues

Kalshi — API Reference

Sport-Aware Commands

Raw API Commands

Sport Codes

US Sports

Football (Soccer)

See references/series-tickers.md for the full series ticker list and references/api.md for raw API documentation.

Price Scale

Kalshi prices are on a 0-100 integer scale:

• last_price of 20 = 20% implied probability
• yes_bid / no_bid = current bid prices for Yes and No sides
• Always use status="open" to exclude settled/closed markets

Kalshi API

• Base URL: https://api.elections.kalshi.com/trade-api/v2
• All endpoints are public, read-only. No authentication required.

Valid Commands & Common Mistakes

CRITICAL: Always use the sport parameter

For single-game markets, ALWAYS pass sport='<code>' to search_markets and get_todays_events.

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

Sport-Aware Commands (recommended)

These use sport codes (nba, nfl, mlb, epl, ucl, etc.) — same interface as Polymarket:

• get_sports_config — list all available sport codes and series tickers
• get_todays_events — today's events for a sport (requires sport param)
• search_markets — find markets by sport and keyword (use sport param for single-game markets)

Raw API Commands

These query the Kalshi API directly using series/event/market tickers:

• get_exchange_status
• get_exchange_schedule
• get_series_list
• get_series
• get_events
• get_event
• get_markets
• get_market
• get_market_orderbook
• get_trades
• get_market_candlesticks
• get_sports_filters

Key Usage Patterns

Finding sport markets (MOST COMMON)

# Use the sport parameter — maps to the right series ticker(s) automatically
sports-skills kalshi search_markets --sport=nba
sports-skills kalshi search_markets --sport=nba --query="Lakers"
sports-skills kalshi search_markets --sport=epl --query="Leeds"
sports-skills kalshi get_todays_events --sport=nba
sports-skills kalshi get_todays_events --sport=epl

Discovering sport codes

sports-skills kalshi get_sports_config
# Returns: nba, nfl, mlb, nhl, wnba, cfb, cbb, epl, ucl, laliga, bundesliga, seriea, ligue1, mls, worldcup

Commands that DO NOT exist (commonly hallucinated)

• ~~get_odds~~ / ~~get_probability~~ — market prices ARE the implied probability. Use search_markets or get_todays_events, which return last_price in cents (e.g., 20 = 20% implied probability).
• ~~get_market_odds~~ — use search_markets/get_todays_events and interpret last_price as probability. Note: raw get_market/get_markets payloads carry dollar-string fields instead (last_price_dollars: "0.2000"), not integer cents.
• ~~get_series_by_sport~~ — use get_sports_config() to see sport codes and series tickers.

Other common mistakes

• Not using the `sport` parameter — without it, you need to know series tickers. search_markets(sport='nba') automatically resolves to KXNBA. search_markets(sport='epl') resolves to all EPL series.
• Searching by team name without `sport` — search_markets(query="Leeds") returns 0 results. Always include sport='epl'.
• Confusing NFL with football on Kalshi — Kalshi's "Football" category = NFL. For football (EPL, UCL, etc.), use epl, ucl, laliga, etc.
• Guessing series or event tickers instead of using get_sports_config() or get_series_list().
• Forgetting status="open" when querying raw markets — without it, results include settled/closed markets.

If you're unsure whether a command exists, check this list. Do not try commands that aren't listed above.

Sport Codes & Series Tickers

Sport Codes (use with search_markets, get_todays_events)

US Sports

Football

Use get_sports_config() to see all available codes.

Football leagues have multiple series per league. The sport parameter queries all of them automatically. For example, search_markets(sport='epl') queries KXEPLGAME, KXEPLTOTAL, KXEPLBTTS, KXEPLSPREAD, and KXEPLGOAL in one call.

Other Football Series Tickers (raw API only)

Note: On Kalshi's API, "Football" = American Football (NFL). Football leagues are categorized under "Soccer" in Kalshi's taxonomy.

Not all football leagues have futures/winner markets. Use get_sports_filters() to discover all available competitions.