🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Kalshi

by @henrik-openclaw

Read-only Kalshi prediction market integration. Use for viewing markets, checking portfolio positions, analyzing prediction opportunities, and finding high-payoff/high-certainty trades. Triggers on Kalshi, prediction markets, event contracts, or trading recommendations.

Versionv1.1.0
Downloads3,287
Stars⭐ 3
TERMINAL
clawhub install kalshi

πŸ“– About This Skill


name: kalshi description: Read-only Kalshi prediction market integration. Use for viewing markets, checking portfolio positions, analyzing prediction opportunities, and finding high-payoff/high-certainty trades. Triggers on Kalshi, prediction markets, event contracts, or trading recommendations.

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):

    1. Go to kalshi.com/account/profile 2. Create new API key β†’ save the Key ID and download the private key 3. Store credentials:

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

    4. 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)

    Categories

    Kalshi markets span:

  • Politics & Elections
  • Economics (Fed rates, inflation, GDP)
  • Weather & Climate
  • Finance (stock prices, crypto)
  • Entertainment & Sports
  • Science & Tech
  • 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
  • βš™οΈ Configuration

    Install dependencies:

    pip install requests cryptography
    

    For portfolio access (RSA key signing required):

    1. Go to kalshi.com/account/profile 2. Create new API key β†’ save the Key ID and download the private key 3. Store credentials:

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

    4. 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