使用说明
@quantish/服务器
Polymarket的自托管Quantish交易MCP服务器。
运行您自己的交易基础设施,完全控制您的钱包密钥。
安装
npm install @quantish/server
快速开始
import { createServer, PostgresAdapter } from '@quantish/server';
const server = await createServer({
database: new PostgresAdapter({
connectionString: process.env.DATABASE_URL
}),
encryption: {
masterKey: process.env.QUANTISH_MASTER_KEY
}
});
server.listen(3000);
配置
环境变量
| 变量 | 描述 |
|---|---|
DATABASE_URL |
PostgreSQL连接字符串 |
QUANTISH_MASTER_KEY |
用于钱包加密的32字节十六进制密钥 |
POLYMARKET_API_KEY |
Polymarket Builder API密钥(可选) |
POLYMARKET_API_SECRET |
Polymarket Builder API机密(可选) |
POLYMARKET_PASSPHRASE |
Polymarket Builder密码(可选) |
生成主密钥
npx quantish generate-key
数据库设置
服务器需要PostgreSQL。运行附带的迁移:
npx prisma migrate deploy
或者使用提供的模式手动创建表。
API终点
健康检查
GET /health
钱包操作
GET /v1/wallet/status - Get wallet setup status
POST /v1/wallet/setup - Initialize wallet (Safe deployment, approvals)
GET /v1/wallet/balances - Get USDC/MATIC balances
POST /v1/wallet/transfer - Transfer USDC
交易操作
POST /v1/trade/buy - Buy shares
POST /v1/trade/sell - Sell shares
POST /v1/trade/order - Place custom order
DELETE /v1/trade/orders/:id - Cancel order
GET /v1/trade/orders - List orders
职位
GET /v1/positions - List positions
GET /v1/positions/all - Include transferred shares
GET /v1/positions/claimable - Check for winnings
POST /v1/positions/claim - Claim all winnings
MCP端点
要与Quantish Agent CLI一起使用,请公开JSON-RPC 2.0端点:
POST /mcp/execute
Content-Type: application/json
X-API-Key: <user-api-key>
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_balances",
"arguments": {}
},
"id": 1
}
包裹
此monorepo包含:
| 包装 | 描述 |
|---|---|
@quantish/server |
带交易端点的Express服务器 |
@quantish/core |
加密、签名、钱包实用程序 |
@quantish/types |
TypeScript类型定义 |
发展
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run in development
pnpm dev
安全
- 所有私钥均使用AES-256-GCM加密
- 支持HMAC请求签名
- API密钥在存储前进行散列
- 非托管:用户可以导出他们的密钥
许可证
PolyForm非商业版1.0.0
