kalshi

Kalshi MCP 服务

mcp-name: io.github.yakub268/kalshi

用于 Kalshi 预测市场的 Model Context Protocol 服务。 通过 Claude Desktop 直接搜索、分析和交易预测市场。

基于生产级身份验证和速率限制机制构建，源自已连续运行 4 个多月的实盘交易系统。

功能

工具（6 个）

• search_markets - 按关键词搜索，获取价格和交易量
• get_market_details - 获取完整市场信息和订单簿深度
• get_portfolio - 获取账户余额和未平仓头寸
• get_trending_markets - 按 24 小时交易量获取热门市场
• place_order - 执行限价单
• get_series_markets - 获取某个系列中的所有市场（例如，美联储事件）

资源（2 个）

• kalshi://balance - 当前账户余额
• kalshi://positions - 未平仓头寸列表

安装

前置条件

1. Kalshi API 凭据：从 kalshi.com/profile/api-keys 获取

   • 下载 API 密钥 ID
   • 下载 RSA 私钥（.pem 文件）

2. Python 3.10+

快速安装（PyPI）

pip install kalshi-mcp

从源代码安装

# Clone repository
git clone https://github.com/yakub268/kalshi-mcp.git
cd kalshi-mcp

# Install dependencies
pip install -e .

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kalshi": {
      "command": "python",
      "args": ["-m", "kalshi_mcp"],
      "env": {
        "KALSHI_API_KEY": "your-api-key-here",
        "KALSHI_PRIVATE_KEY_PATH": "C:\\Users\\YourName\\.trading_keys\\kalshi_private_key.pem"
      }
    }
  }
}

注意：

• 将 your-api-key-here 替换为实际的 Kalshi API 密钥
• 将私钥路径更新为保存 .pem 文件的位置
• 在 Windows 上，路径中使用双反斜杠（\\）

测试连接

重启 Claude Desktop，然后尝试：

What's my Kalshi balance?

或

Search for bitcoin prediction markets

使用示例

搜索市场

Search for markets about the Federal Reserve

获取市场分析

Show me details for ticker KXFED-26MAR19-B5.25

查看投资组合

What's my current Kalshi portfolio?

下单

Buy 10 contracts of KXHIGHNYC-26FEB20-B34.5 YES at 25 cents

身份验证

此服务使用 RSA-PSS 签名身份验证：

1. 每个请求都使用你的私钥签名
2. Kalshi 使用你的公钥验证签名
3. 线程安全的速率限制（请求间隔 150 毫秒）
4. 遇到 429 速率限制错误时自动重试

安全性：你的私钥不会离开本机。服务只会在本地对请求进行签名。

速率限制

• 内置请求间隔 150 毫秒（约 6.6 次请求/秒）
• 遇到 429 错误时自动采用指数退避（0.5 秒 → 1 秒 → 2 秒）
• 可安全地在多个 Claude 对话中并发使用

架构

基于实盘 Kalshi 交易机器人中的生产代码构建：

• 身份验证：复用自 kalshi_client.py（连续运行 4 个多月）
• 速率限制：所有客户端实例共享
• 错误处理：经过实战检验的重试逻辑
• 市场发现：采用 scanner.py 中的流动性评分机制

贡献

欢迎提交问题和 PR！这是一个开源项目，旨在填补 MCP 生态系统中的空白。

许可证

MIT License - 参见 LICENSE 文件

致谢

• 使用 FastMCP 构建
• Kalshi API 文档：docs.kalshi.com
• 实盘代码来自我的交易机器人库

---

有疑问？ 请提交问题或通过 GitHub 联系我们。