量化交易服务器

自托管的量化交易MCP服务器,提供完整的钱包控制和交易基础设施。

  • by joinQuantish
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 joinQuantish/quantish-server

使用说明

@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