---
name: velcrafting/kalshi-markets
source: https://app.decimal.ai/s/velcrafting-kalshi-markets@1/SKILL.md
source_sha256: 9be1c4479b64
---

# Kalshi Markets

Standalone, self-contained scripts for Kalshi prediction markets.
Each script is independently executable with zero dependencies between scripts.

## Instructions

- **Default to `--json` flag** for all commands when processing data
- Prioritize high volume markets, series, and events.
- **IMPORTANT**: **Don't read scripts unless absolutely needed** - instead, use `<script.py> --help` to understand options and then call the script with `uv run <script.py> <options>` to get the data you need.
- All scripts work from any directory (use absolute paths internally)

## Progressive Disclosure

Each script contains ~200-300 lines with complete functionality.
Only load the script you need - no unnecessary context.

## Available Scripts

### `scripts/status.py`
**When to use:** Check if Kalshi exchange is operational

### `scripts/markets.py`
**When to use:** Browse available prediction markets

### `scripts/market.py`
**When to use:** Get comprehensive details about a specific market

### `scripts/orderbook.py`
**When to use:** View bid/ask levels for a market

### `scripts/trades.py`
**When to use:** Monitor recent trading activity

### `scripts/search.py`
**When to use:** Find markets by keyword (uses intelligent caching)

### `scripts/events.py`
**When to use:** List groups of related markets

### `scripts/event.py`
**When to use:** Get details about a specific event

### `scripts/series_list.py`
**When to use:** Browse all market templates (~6900 available)

### `scripts/series.py`
**When to use:** Get information about a specific market template

## Architecture

- **Self-Contained:** Each script includes all necessary code
- **No External Dependencies:** HTTP client embedded in each script
- **Progressive Discovery:** Only see what you need
- **Incrementally Adoptable:** Use one script or many

## Quick Start

All scripts support `--help` and `--json`:

```bash
uv run scripts/[script].py --help
uv run scripts/[script].py --json
```

No authentication required for any script.