使用说明
@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-将结果代币卖回USDCkalshi_get_positions-查看当前职位kalshi_get_orders-查看订单历史记录
掉期(SOL/USDC)
kalshi_get_swap_quote-获取Jupiter掉期报价kalshi_execute_swap-执行令牌交换kalshi_swap_sol_to_usdc-将SOL兑换为USDCkalshi_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
资源
- NPM: @quantish/kalshi服务器
- GitHub: joinQuantish/kalshi mcp
- Quantish试剂: @定量/试剂
- DFlow文档: 庞德dflow.net
- 木星之门: portal.jup.ag
许可证
该项目根据 PolyForm非商业许可证1.0.0.
免费用于个人使用、研究和非商业目的。 商业用途需要获得Quantish股份有限公司的明确许可联系方式hello@quantish.live商业许可。
建造于 Quantish股份有限公司。