How do I install the Kalshi skill?

Run npx skillmds@latest add dvcrn/kalshi-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Kalshi safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kalshi?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kalshi free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Kalshi?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kalshi by dvcrn — Agent Skill

Name: Kalshi
Rating: 4.2 (5 reviews)
Author: dvcrn

Kalshi

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.

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

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

---name: kalshi-2description: 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: ```bash pip install requests cryptography ``` For portfolio access (RSA key signing required): 1. Go to [kalshi.com/account/profile](https://kalshi.com/account/profile) 2. Create new API key → save the **Key ID** and download the **private key** 3. Store credentials: ```bash mkdir -p ~/.kalshi mv ~/Downloads/your-key-file.txt ~/.kalshi/private_key.pem chmod 600 ~/.kalshi/private_key.pem ``` 4. Create `~/.kalshi/credentials.json`: ```json { "api_key_id": "your-key-id-here", "private_key_path": "~/.kalshi/private_key.pem" } ``` Or run interactive setup: ```bash python scripts/kalshi_portfolio.py setup ``` ## Scripts ### Market Data (No Auth Required) ```bash # 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) ```bash # 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

Frequently asked questions