Kalshi预测市场交易服务器

一个自托管的Kalshi MCP服务器,用于通过DFlow协议在Solana上进行Kalshi预测市场交易。

  • by joinQuantish
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 joinQuantish/kalshi-mcp

使用说明

@quantish/kalshi服务器

⚠️ 注意:Quantish即将结束。 Quantish平台(Quantish.live)正在关闭。此MCP服务器是自托管的,将继续独立工作,但Quantish团队将不再维护或更新此项目。如果您正在构建预测市场空间并需要实时数据基础设施,请查看 polynode.dev.

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

概述

该软件包提供了一个MCP(模型上下文协议)服务器,使AI代理能够通过Solana上的DFlow协议在Kalshi预测市场上进行交易。

特性

  • 完整的Kalshi交易 -在任何Kalshi市场买卖
  • Solana钱包管理 -生成和管理Solana钱包
  • DFlow集成 -通过DFlow的Solana基础设施进行贸易
  • 木星互换 -通过Jupiter聚合器交换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终结点(默认为主网)
ADMIN_API_KEY 管理终结点没有 Admin API密钥
PORT 否 服务器端口(默认为3002)

获取API密钥

DFlow API密钥:

DFlow访问可能需要批准。联系DFlow团队: dflow.net 用于API访问。

Jupiter API密钥:

从获取免费的API密钥 portal.jup.ag (基本层,1个RPS)。交换功能所需。

使用Quantish的公共服务器? 随着平台的逐步关闭,Quantish的公共服务器不再可用。您必须自行托管此MCP服务器才能使用它。按照上面的设置说明运行您自己的实例。

生成加密密钥

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

数据库设置

任何PostgreSQL数据库都可以工作。选项:

提供者 备注
铁路 添加PostgreSQL服务,复制 DATABASE_URL 从变量
Supabase 免费套餐 网站 supabase.com,从“设置”>“数据库”复制连接字符串
霓虹 无服务器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 -不购买结果代币
  • 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格式

服务器在以下位置公开JSON-RPC 2.0端点 /mcp:

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

配置CLI以使用您的服务器:

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

资源

许可证

该项目根据 PolyForm非商业许可证1.0.0.

免费用于个人使用、研究和非商业目的。 商业用途需要获得Quantish股份有限公司的明确许可联系方式hello@quantish.live商业许可。


建造于 Quantish股份有限公司。