Kalshi

# Kalshi Prediction Markets

与 Kalshi 预测市场 API 的只读集成。

## 功能

- **浏览市场**：按类别列出活动事件和市场 - **市场分析**：获取价格、成交量、订单簿深度 - **投资组合视图**：查看持仓和盈亏（P&L，需要 API 密钥） - **交易推荐**：寻找高确定性、高回报的机会

## 设置

安装依赖项： ```bash pip install requests cryptography ```

若要访问投资组合（需要 RSA 密钥签名）：

1. 访问 [kalshi.com/account/profile](https://kalshi.com/account/profile) 2. 创建新的 API 密钥 → 保存 **Key ID** 并下载 **私钥** 3. 存储凭据：

```bash mkdir -p ~/.kalshi mv ~/Downloads/your-key-file.txt ~/.kalshi/private_key.pem chmod 600 ~/.kalshi/private_key.pem ```

4. 创建 `~/.kalshi/credentials.json`： ```json { "api_key_id": "your-key-id-here", "private_key_path": "~/.kalshi/private_key.pem" } ```

或者运行交互式设置： ```bash python scripts/kalshi_portfolio.py setup ```

## 脚本

### 市场数据（无需认证）

```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 ```

### 投资组合（需要认证）

```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 ```

## 机会分析

`opportunities` 命令用于识别符合以下条件的市场： - **高确定性**：价格 ≥ 85¢ YES 或 ≤ 15¢ YES（意味着 85%+ 的信心） - **有意义的回报**：本金的潜在回报 ≥ 10% - **充足的流动性**：订单簿深度支持合理的仓位规模

公式：`expected_value = probability * payoff - (1 - probability) * cost`

一个好的机会应满足：`EV / cost > 0.1`（10%+ 的预期回报）

## 类别

Kalshi 市场涵盖： - 政治与选举 - 经济（美联储利率、通胀、GDP） - 天气与气候 - 金融（股票价格、加密货币） - 娱乐与体育 - 科学与技术

## API 参考

有关端点详细信息，请参阅 `references/api.md`。

## 重要说明

- 此技能为 **只读** —— 不执行交易 - 公共端点不需要认证 - 投资组合/余额需要 API 凭据 - 市场以美分为结算单位（100¢ = $1） - 所有时间均为 UTC