适用于 Cursor 的 Kalshi 预测市场插件

一个 Cursor 市场插件，连接 Kalshi 预测市场 API，让 AI 智能体能够读取市场，并在获得用户批准后下单交易。

功能特性

• 读取市场数据：浏览市场、查看价格、查看订单簿

• 投资组合管理：查看余额和持仓

• 下单与撤单：在用户明确批准后，方可下单和取消订单

• 演示与生产环境：同时支持演示环境和生产环境

• 安全认证：基于 RSA-PSS 签名的认证

Related MCP server: Kalshi MCP Server

安装

1. 创建 API 密钥

访问 https://kalshi.com/account/profile，然后：

1. 点击"创建新 API 密钥"

2. 保存你的 密钥 ID（KALSHI_ACCESS_KEY）

3. 下载并保存你的 私钥（KALSHI_PRIVATE_KEY）——你将无法再次获取！

如需测试，你也可以在演示环境 https://demo.kalshi.com/account/profile 下创建密钥。

2. 安装插件

1. 打开 Cursor

2. 前往 设置 → 插件 → 市场

3. 搜索 "kalshi"

4. 点击安装

或者克隆此仓库并在本地安装：

git clone https://github.com/evanparrott/kalshi

3. 配置变量

在 Cursor 中，前往 设置 → 插件 → kalshi 并设置：

• KALSHI_ACCESS_KEY：你的 Kalshi API 密钥 ID

• KALSHI_PRIVATE_KEY：你的 RSA 私钥（完整 PEM 文件内容）

• KALSHI_BASE_URL（可选）：

  • 生产环境：https://external-api.kalshi.com（默认）

  • 演示环境：https://external-api.demo.kalshi.co

可用工具

只读工具（安全）

• kalshi_get_balance - 查看账户余额和投资组合价值

• kalshi_list_markets - 浏览可用的预测市场

• kalshi_get_market - 获取指定市场的详细信息

• kalshi_get_orderbook - 查看带价格的当前订单簿

• kalshi_get_positions - 查看当前持仓

• kalshi_list_orders - 查看当前委托

写入工具（需要用户批准）

• kalshi_create_order - 提交新订单

• kalshi_cancel_order - 取消现有订单

使用示例

浏览市场

"What prediction markets are available on Kalshi?"

查看余额

"What's my Kalshi account balance?"

获取市场信息

"Show me details about the market HIGHNY-24JAN01-T60"

下单（需要确认）

"Buy 10 YES contracts on HIGHNY-24JAN01-T60 at 56 cents"

智能体会按以下步骤执行：

1. 向你展示市场详情

2. 显示当前订单簿

3. 请求并得到你的明确确认

4. 确认后才下单

安全特性

• 技能文件：该插件包含一个技能文件，智能体在交易之前必须阅读

• 必须明确批准：未经用户确认，绝不提交订单

• 禁止猜测价格：智能体必须使用实际的订单簿价格

• 确认清晰：所有交易参数都会在执行前确认

• 演示模式：可在演示环境中使用虚拟资金进行安全测试

演示环境与生产环境

演示环境

• Base URL：https://external-api.demo.kalshi.co

• 使用虚拟资金进行测试

• 使用独立的账户和 API 密钥

• 非常适合测试该插件

生产环境

• Base URL：https://external-api.kalshi.com

• 使用真实资金

• 若未设置 KALSHI_BASE_URL，默认使用该环境

请务必先在演示环境中测试！

开发

环境要求

• Node.js 18 或更高版本

• npm

本地开发

# Clone the repository
git clone https://github.com/evanparrott/kalshi
cd kalshi

# Install dependencies
npm install

# Set environment variables
export KALSHI_ACCESS_KEY="your-key-id"
export KALSHI_PRIVATE_KEY="$(cat path/to/your/private-key.pem)"
export KALSHI_BASE_URL="https://external-api.demo.kalshi.co"

# Run the server
npm start

测试

MCP 服务器通过 stdio 通信。你可以使用 MCP Inspector 进行测试，也可以直接集成到 Cursor 中。

发布到 Cursor 市场

本插件旨在提交到 Cursor 市场：

1. 确保满足所有要求：

   • 公开的 GitHub 仓库

   • 有效的 .cursor-plugin/plugin.json

   • 有效的 .cursor-plugin/mcp.json

   • 技能文件位于 skills/kalshi-trading/SKILL.md

   • 可正常工作的 MCP 服务器

   • 仓库中不包含任何机密信息

2. 在 https://cursor.com/marketplace/publish 提交

3. 并提交以下内容：

   • 仓库 URL

   • 插件描述

   • 使用示例

   • 其他特殊安装说明

API 参考

如需 Kalshi 完整 API 文档，请参阅：

• 官方 API 文档

• 入门指南

• API 参考

安全说明

• 切勿将 API 密钥或私钥提交到版本控制

• 安全保存私钥

• 使用演示环境进行测试

• 私钥无法找回——生成后请立即保存

• 插件使用 RSA-PSS SHA256 签名进行身份认证

故障排查

"Failed to parse KALSHI_PRIVATE_KEY"

请确保私钥为 PEM 格式，并包含完整的密钥头（headers）：

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

"Unauthorized" 错误

• 确认你的 KALSHI_ACCESS_KEY 是否正确

• 确保 KALSHI_PRIVATE_KEY 与你的 KALSHI_ACCESS_KEY 对应的密钥匹配

• 检查是否使用了正确的 Base URL（演示环境 vs 生产环境）

"Market not found" 错误

• 确认 ticker 是否正确

• 使用 kalshi_get_market 检查市场状态

• 市场可能已关闭或已结算

许可证

MIT 许可证——详细内容见 LICENSE 文件。

作者

Evan Parrott

贡献

欢迎贡献！请随时提交 Pull Request。

免责声明

本工具是非官方插件，使用风险自负。预测市场交易涉及资金风险。请务必了解你所交易的内容，并且不要投入超出你承受能力的资金。

相关链接

• Kalshi 官网

• Kalshi API 文档

• Cursor 市场

• 报告问题