---
name: trading-kalshi
description: "Kalshi trading - search markets, place orders, stream prices, advanced order types"
commands:
  - /kalshi
  - /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


---
Source attribution: alsk1992
Original project: https://github.com/alsk1992/CloddsBot/blob/c930628c47a4a745f497e29035a3b64622f97cc7/src/skills/bundled/trading-kalshi/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2026 alsk1992

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: alsk1992
Original project: https://github.com/alsk1992/CloddsBot/blob/c930628c47a4a745f497e29035a3b64622f97cc7/src/skills/bundled/trading-kalshi/SKILL.md
Attribution basis: Source repository record

Fields of work: Data & Analytics, Finance & Accounting, Marketing, Sales
Roles: Data Analyst, Financial Analyst, Growth Marketer, Product Marketer, Sales Engineer
Specialties: API
Tools: Kalshi
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 232f5f925c0474fc7f49a44416c984ef7b48fe751e86094f391142f4e8de49dc