# Trading Kalshi

> Kalshi trading - search markets, place orders, stream prices, advanced order types

- Skill: `alsk1992/trading-kalshi` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add alsk1992/trading-kalshi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alsk1992/trading-kalshi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alsk1992 (https://skillmd.com/u/alsk1992)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alsk1992/trading-kalshi

---


# Kalshi Trading

Full access to Kalshi prediction markets: search, trade, stream real-time data, and use advanced order types (TWAP, bracket, trigger).

## Required Environment Variables

```bash
KALSHI_API_KEY_ID=your_api_key_id
KALSHI_PRIVATE_KEY=your_private_key_pem_contents
# OR
KALSHI_PRIVATE_KEY_PATH=/path/to/private_key.pem
```

Authentication uses RSA key-pair signing (not email/password). Generate an API key from the Kalshi dashboard.

Optional:

```bash
DRY_RUN=true   # Simulate trades without executing
```

## Commands

### Market Data

```
/kalshi search <query>                     - Search markets
/kalshi market <ticker>                    - Market details
/kalshi book <ticker>                      - View orderbook (REST snapshot)
/kalshi events [query]                     - Browse events
/kalshi event <event-ticker>              - Event details + markets
```

### Trading

```
/kalshi buy <ticker> <contracts> <price>   - Buy YES contracts
/kalshi sell <ticker> <contracts> <price>  - Sell YES contracts
/kalshi orders                             - View open orders
/kalshi cancel <order-id>                  - Cancel an order
/kalshi cancel all                         - Cancel all orders
/kalshi balance                            - Account balance
```

### Advanced Orders

```
/kalshi twap <buy|sell> <ticker> <total> <price> [slices] [interval-sec]
/kalshi twap status                        - Active TWAP progress
/kalshi twap cancel <id>                   - Cancel TWAP

/kalshi bracket <ticker> <size> <tp> <sl>  - Set take-profit / stop-loss
/kalshi bracket status                     - Active brackets
/kalshi bracket cancel <id>                - Cancel bracket

/kalshi trigger buy <ticker> <size> <price> [limit]   - Buy when price drops
/kalshi trigger sell <ticker> <size> <price> [limit]  - Sell when price rises
/kalshi trigger list                       - Active triggers
/kalshi trigger cancel <id>                - Cancel trigger
```

### Real-Time Streaming (WebSocket)

```
/kalshi stream <ticker> [channels]         - Start streaming (ticker,trade,orderbook)
/kalshi stream-fills                       - Stream your order fills
/kalshi streams                            - List active streams
/kalshi unstream <ticker>                  - Stop streaming a market
/kalshi unstream-fills                     - Stop fill notifications
/kalshi realtime-book <ticker>             - Get real-time orderbook from stream
```

### Cross-Platform

```
/kalshi route <ticker> <buy|sell> <size>   - Compare prices across platforms
/kalshi circuit                            - Circuit breaker status
```

## Examples

```
/kalshi search bitcoin
/kalshi market KXBTC-24JAN01
/kalshi book KXBTC-24JAN01
/kalshi buy KXBTC-24JAN01 10 0.65
/kalshi sell KXBTC-24JAN01 5 0.70
/kalshi stream KXBTC-24JAN01 ticker,trade
/kalshi twap buy KXBTC-24JAN01 50 0.60 10 30
/kalshi bracket KXBTC-24JAN01 10 0.80 0.40
/kalshi trigger buy KXBTC-24JAN01 10 45
```

## Notes

- Prices are in decimal format for commands (0.65 = 65 cents)
- Trigger prices are in cents (45 = 45 cents)
- Contracts pay $1 if correct; cost is the price
- Circuit breaker integration blocks trades when risk limits are hit
- Trigger orders poll every 5 seconds