kalshi-agent

Kalshi Agent Skill

CLI tool for trading prediction markets on Kalshi.

Installation

npm install -g kalshi-cli

Configuration

1. Get API credentials at: https://kalshi.com/api
2. Place your RSA private key at ~/.kalshi/private_key.pem
3. Set your access key in ~/.kalshi/.env:

KALSHI_ACCESS_KEY=your_access_key_id

Or run kalshi setup-shell to add it to your shell config.

---

Commands

Browse & Research

# List open markets (default 20)
kalshi markets
kalshi markets -l 50
kalshi markets --status settled

# Search by keyword, ticker, or category
kalshi search "Super Bowl"
kalshi search soccer
kalshi search hockey
kalshi search KXWO-GOLD-26

# Search with filters
kalshi search politics --min-odds 5     # hide markets where either side < 5%
kalshi search soccer --expiring          # sort by soonest expiry, show expiry column
kalshi search soccer -e -m 2 -l 20      # combine flags: expiring, 2% min-odds, 20 results

# Browse all active series (interactive — pick a number to drill down)
kalshi series
kalshi series soccer
kalshi series --all                      # include series with no active markets
kalshi series -e                         # sort by soonest expiry

# View single market detail
kalshi detail KXWO-GOLD-26-NOR

# View orderbook depth
kalshi orderbook KXWO-GOLD-26-NOR

Search Behavior

Search uses a multi-strategy approach:

1. Direct ticker lookup — tries the query as a market ticker, event ticker (KX prefix), or series ticker
2. Series matching — dynamically searches all Kalshi series by title, category, and tags (e.g. "soccer" matches series tagged "Soccer")
   • If many series match, shows an interactive numbered list — enter a number to drill into that series' markets
   • If few series match, fetches and displays markets directly
3. Market title search — falls back to searching open market titles/tickers

Common sport/category aliases are expanded automatically (e.g. "nfl" also searches "football").

Interactive Series Lists

Both kalshi search and kalshi series display numbered tables when listing series. After the table, you're prompted:

Enter # to drill down (or q to quit):

Pick a number to load that series' open markets inline. The prompt loops so you can explore multiple series without re-running the command.

Portfolio

# Check balance
kalshi balance

# View positions
kalshi positions

# View open orders
kalshi orders

Trading

# Buy 10 YES contracts at 68c each
kalshi buy KXSB-26 10 68

# Buy NO contracts
kalshi buy KXWO-GOLD-26-NOR 5 32 --side no

# Sell (same syntax)
kalshi sell KXWO-GOLD-26-NOR 5 40 --side no

# Skip confirmation prompt
kalshi buy KXSB-26 10 68 --force

# Cancel an open order
kalshi cancel <order-id>

Notes

• Prices are in cents (68 = $0.68 = 68% implied probability)
• Prices display as both dollars and percentages (e.g. $0.68 (68%))
• --side defaults to yes if not specified
• buy and sell show a cost/proceeds summary and ask for confirmation (bypass with --force)
• --min-odds / -m filters out markets where either side's bid is below a percentage threshold (default 0.5%)
• --expiring / -e sorts results by soonest expiry, adds an "Expires" column, and excludes already-expired entries
• Expiry times are human-readable: "8h 35m", "Fri 04:00PM", "Apr 01", "Jan 01, 2027"
• Event tickers start with KX (e.g. KXWO-GOLD-26); market tickers have more segments (e.g. KXWO-GOLD-26-NOR)
• Market tables show outcome names (e.g. "Norway" instead of raw tickers) when available

---

API Reference

Full API docs: https://docs.kalshi.com/api-reference/