@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主机上运行
快速开始```bash
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服务器才能使用它。按照上面的设置说明运行您自己的实例。
### 生成加密密钥```bash
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 然后运行:```bash
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`:```bash
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以使用您的服务器:```bash
export KALSHI_MCP_URL=https://your-server.com/mcp
export KALSHI_API_KEY=your-api-key
quantish
或添加到 `~/.quantish/config.json`:```json
{
"kalshiMcpUrl": "https://your-server.com/mcp",
"kalshiApiKey": "your-api-key"
}
发展```bash
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股份有限公司。
