Kalshi MCP Server

@quantish/kalshi-server

⚠️ 注意：Quantish 即将停止运营。 Quantish 平台（quantish.live）即将关闭。此 MCP 服务可自托管，将继续独立运行，但 Quantish 团队将不再维护或更新此项目。如果你正在构建预测市场相关项目，并需要实时数据基础设施，请查看 polynode.dev。

用于通过 Solana 上的 DFlow 在 Kalshi 市场进行交易的可自托管 Kalshi MCP 服务。

概览

此软件包提供一个 MCP（Model Context Protocol）服务，使 AI Agent 能够通过 Solana 上的 DFlow 协议，在 Kalshi 预测市场进行交易。

功能

• 完整的 Kalshi 交易功能 - 在任何 Kalshi 市场买入／卖出
• Solana 钱包管理 - 生成和管理 Solana 钱包
• DFlow 集成 - 通过 DFlow 的 Solana 基础设施进行交易
• Jupiter 兑换 - 通过 Jupiter Aggregator 兑换 SOL／USDC
• 兼容 MCP - 可与 Claude、Quantish Agent 及任何 MCP 客户端配合使用
• 可自托管 - 可部署在 Railway、Fly.io 或任何 Node.js 主机上

快速开始

git clone https://github.com/joinQuantish/kalshi-mcp
cd kalshi-mcp
npm install

环境变量

变量	必需	说明
DATABASE_URL	是	PostgreSQL 连接字符串
ENCRYPTION_KEY	是	用于加密钱包的 64 位十六进制字符串
DFLOW_API_KEY	否	DFlow API 密钥（可选，用于经过身份验证的端点）
JUPITER_API_KEY	否	用于兑换工具的 Jupiter API 密钥，可从 portal.jup.ag 获取
SOLANA_RPC_URL	否	Solana RPC 端点（默认为 mainnet）
ADMIN_API_KEY	否	管理端点的管理员 API 密钥
PORT	否	服务端口（默认为 3002）

获取 API 密钥

DFlow API 密钥：

访问 DFlow 可能需要审批。请通过 dflow.net 联系 DFlow 团队以获取 API 访问权限。

Jupiter API 密钥：

从 portal.jup.ag 免费获取 API 密钥（Basic 级别，1 RPS）。兑换功能需要此密钥。

使用 Quantish 的公共服务？ 随着平台即将停止运营，Quantish 的公共服务已不再提供。你必须自行托管此 MCP 服务才能使用。请按照上述设置说明运行自己的实例。

生成加密密钥

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

数据库设置

任何 PostgreSQL 数据库都可以使用。可选方案：

提供商	说明
Railway	添加 PostgreSQL 服务，并从变量中复制 DATABASE_URL
Supabase	在 supabase.com 提供免费套餐，从 Settings > Database 复制连接字符串
Neon	neon.tech 提供无服务器 Postgres，并提供免费套餐
本地 Docker	docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres

设置 DATABASE_URL，然后运行：

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

可用工具

账户管理

• kalshi_signup - 创建带有 Solana 钱包的账户
• kalshi_request_api_key - 使用访问码申请 API 密钥
• kalshi_get_wallet_info - 获取钱包地址和类型
• kalshi_get_wallet_status - 获取包含余额的完整钱包状态
• kalshi_get_balances - 获取 SOL 和 USDC 余额
• kalshi_get_deposit_address - 获取存款地址
• kalshi_export_private_key - 导出钱包私钥
• kalshi_import_private_key - 导入现有的 Solana 钱包

市场发现

• kalshi_search_markets - 按关键词搜索 Kalshi 市场
• kalshi_get_market - 按代码获取市场详情
• kalshi_get_event - 获取包含所有嵌套市场的事件
• kalshi_get_events - 按筛选条件浏览事件
• kalshi_get_live_data - 获取实时定价数据

交易

• kalshi_get_quote - 获取预测市场交易报价
• kalshi_buy_yes - 买入 YES 结果代币
• kalshi_buy_no - 买入 NO 结果代币
• kalshi_sell_position - 将结果代币卖回 USDC
• kalshi_get_positions - 查看当前持仓
• kalshi_get_orders - 查看订单历史

兑换（SOL/USDC）

• kalshi_get_swap_quote - 获取 Jupiter 兑换报价
• kalshi_execute_swap - 执行代币兑换
• kalshi_swap_sol_to_usdc - 将 SOL 兑换为 USDC
• kalshi_swap_usdc_to_sol - 将 USDC 兑换为 SOL

转账

• kalshi_send_sol - 向另一个钱包发送 SOL
• kalshi_send_usdc - 向另一个钱包发送 USDC
• kalshi_send_token - 发送任意 SPL 代币

市场操作

• kalshi_check_market_initialization - 检查市场是否已在链上代币化
• kalshi_initialize_market - 在链上初始化市场（需支付 SOL 费用）
• kalshi_check_redemption_status - 检查市场是否已结算
• kalshi_get_market_by_mint - 按代币铸造地址查找市场

赎回

• kalshi_get_redeemable_positions - 查找可领取的持仓
• kalshi_redeem_winnings - 赎回指定的获胜持仓
• kalshi_redeem_all_positions - 一次性赎回所有获胜持仓

API 密钥管理

• kalshi_list_api_keys - 列出你的 API 密钥
• kalshi_create_additional_api_key - 创建新的 API 密钥
• kalshi_revoke_api_key - 撤销 API 密钥

API 格式

此服务在 /mcp 提供 JSON-RPC 2.0 端点：

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "kalshi_get_positions",
      "arguments": {}
    },
    "id": 1
  }'

连接到 Quantish Agent

配置命令行以使用你的服务：

export KALSHI_MCP_URL=https://your-server.com/mcp
export KALSHI_API_KEY=your-api-key
quantish

或添加到 ~/.quantish/config.json：

{
  "kalshiMcpUrl": "https://your-server.com/mcp",
  "kalshiApiKey": "your-api-key"
}

开发

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

资源

• NPM： @quantish/kalshi-server
• GitHub：joinQuantish/kalshi-mcp
• Quantish Agent：@quantish/agent
• DFlow 文档：pond.dflow.net
• Jupiter 门户：portal.jup.ag

许可证

本项目采用 PolyForm Noncommercial License 1.0.0 授权。

可免费用于个人用途、研究和非商业用途。 商业用途需获得 Quantish Inc. 的明确许可。商业授权请联系 [email protected]。

---

由 Quantish Inc. 构建