用途：让智能体或脚本操作 Kalshi 预测市场，并回答公开 API 无法直接给出的历史价格与类别级盈亏问题。公开 API 只返回当前价格和扁平持仓，因此历史与聚合分析依赖本地快照库。
主要能力：完整覆盖账户、API 密钥、报价请求、事件、交易所状态、FCM、历史数据、激励计划、直播数据、市场、里程碑、多变量事件集合、投资组合等接口。独有能力包括：portfolio attribution 按市场类别与系列归因已实现盈亏；markets history 展示某市场 yes/no 价格随时间变化（含 sparkline），来自每次 markets sync 抓取的快照；portfolio winrate 计算胜负比、期望值与 ROI；portfolio calendar 查看未来结算与预期赔付；markets movers 找出最大价格波动；markets correlate 用皮尔逊相关系数分析两个市场价格历史；portfolio exposure 按类别拆分敞口并在超过阈值时警告；watch diff 维护本地自选列表并对比上次同步；subaccounts rollup 汇总各子账户持仓与风险。
使用方式：先安装并验证 CLI。安装：npx -y @mvanhorn/printing-press-library install kalshi --cli-only；验证：kalshi-pp-cli --version。若 npx 失败可用 Go 安装（需 Go 1.26.6+）：go install github.com/mvanhorn/printing-press-library/library/payments/kalshi/cmd/kalshi-pp-cli@latest，并确保 GOPATH/bin 在 PATH。示例：kalshi-pp-cli portfolio attribution --since 2026-01-01 --by category --json；kalshi-pp-cli markets history KXPRES-2028-DJT --since 2026-04-01 --sparkline。
适用场景：投资组合日终对账、跨市场相关性信号发现、按类别评估策略表现、使用只读凭据进行安全脚本编写。
限制：需先安装 CLI 并在 PATH 中可见；只读密钥与读写密钥存在层级差异，每个变更命令支持 --dry-run，并提供全局 --read-only 客户端锁阻断所有变更命令；历史与聚合分析依赖本地快照，需先同步数据。价格、收费、平台等其余细节暂未提供。