Kalshi Prediction Markets

Read-only integration with Kalshi's prediction market API.

Capabilities

Browse markets: List active events and markets by category
Market analysis: Get prices, volumes, orderbook depth
Portfolio view: Check positions and P&L (requires API key)
Trade recommendations: Find high-certainty, high-payoff opportunities

Setup

Install dependencies:

pip install requests cryptography

For portfolio access (RSA key signing required):

Go to kalshi.com/account/profile
Create new API key → save the Key ID and download the private key
Store credentials:

mkdir -p ~/.kalshi
mv ~/Downloads/your-key-file.txt ~/.kalshi/private_key.pem
chmod 600 ~/.kalshi/private_key.pem

Create ~/.kalshi/credentials.json:

{
  "api_key_id": "your-key-id-here",
  "private_key_path": "~/.kalshi/private_key.pem"
}

Or run interactive setup:

python scripts/kalshi_portfolio.py setup

Scripts

Market Data (No Auth Required)

# List trending markets
python scripts/kalshi_markets.py trending

# Search markets by query
python scripts/kalshi_markets.py search "bitcoin"

# Get specific market details
python scripts/kalshi_markets.py market TICKER

# Find high-value opportunities
python scripts/kalshi_markets.py opportunities

Portfolio (Auth Required)

# View positions
python scripts/kalshi_portfolio.py positions

# View balance
python scripts/kalshi_portfolio.py balance

# Trade history
python scripts/kalshi_portfolio.py history

Opportunity Analysis

The opportunities command identifies markets where:

High certainty: Price ≥85¢ YES or ≤15¢ YES (implies 85%+ confidence)
Meaningful payoff: Potential return ≥10% on capital
Sufficient liquidity: Orderbook depth supports reasonable position size

Formula: expected_value = probability payoff - (1 - probability) cost

A good opportunity has: EV / cost > 0.1 (10%+ expected return)

API Reference

See references/api.md for endpoint details.

Important Notes

This skill is READ-ONLY — no trade execution
Public endpoints don't require authentication
Portfolio/balance requires API credentials
Markets settle in cents (100¢ = $1)
All times in UTC

Kalshiv1.1.0

Install & Quick Start