kalshi

# Kalshi

Trade on Kalshi prediction markets via a self-contained CLI script. Supports market search, portfolio tracking, and full order lifecycle (place/cancel/monitor).

## Quick Start

All commands route through a single script. Output is JSON.

## CLI

**Primary script:**

```bash
{baseDir}/scripts/kalshi-cli.mjs <command> [args...]
```

**Helper script:**

```bash
{baseDir}/scripts/quick-analysis.mjs <ticker>
```

Combines market details + orderbook in a single call for fast analysis.

## Commands

| Command                                   | Description                                      |
| ----------------------------------------- | ------------------------------------------------ |
| `balance`                                 | Get account balance (cash + portfolio value)     |
| `portfolio`                               | Get balance + all open positions                 |
| `trending`                                | Top markets by 24h volume                        |
| `search <query>`                          | Search markets by keyword                        |
| `market <ticker>`                         | Get details for a single market                  |
| `orderbook <ticker>`                      | Get bid/ask levels for a market                  |
| `buy <ticker> <yes\|no> <count> <price>`  | Place a buy order (price in cents 1-99)          |
| `sell <ticker> <yes\|no> <count> <price>` | Place a sell order (price in cents 1-99)         |
| `cancel <orderId>`                        | Cancel a resting order                           |
| `orders [resting\|canceled\|executed]`    | List orders, optionally filtered by status       |
| `fills [ticker]`                          | List recent fills, optionally filtered by ticker |

## Examples

```bash
# Check balance
{baseDir}/scripts/kalshi-cli.mjs balance

# See what's trending
{baseDir}/scripts/kalshi-cli.mjs trending

# Search for markets about bitcoin
{baseDir}/scripts/kalshi-cli.mjs search "bitcoin"...