PolyHermes/backend/README.md

Polymarket Bot Backend

Polymarket 预测市场机器人后端服务

功能特性

• ✅ 封装 Polymarket CLOB API（订单操作、市场数据、交易数据）
• ✅ 封装 Polymarket Gamma API（市场、事件、系列查询）
• ✅ WebSocket 转发服务（转发前端 WebSocket 连接到 Polymarket RTDS）
• ✅ 统一 API 响应格式
• ✅ 分类验证（仅支持 sports 和 crypto）
• ✅ 工具类支持（安全转换、数学运算、HTTP 客户端等）

技术栈

• Spring Boot 3.2.0
• Kotlin 1.9.20
• Retrofit 2.9.0
• OkHttp 4.12.0
• Java-WebSocket 1.5.4
• MySQL 8.2.0
• Flyway（数据库迁移）

项目结构

backend/
├── src/
│   ├── main/
│   │   ├── kotlin/com/wrbug/polymarketbot/
│   │   │   ├── api/              # API 接口定义
│   │   │   ├── config/           # 配置类
│   │   │   ├── controller/      # 控制器
│   │   │   ├── dto/              # 数据传输对象
│   │   │   ├── service/          # 服务层
│   │   │   ├── util/             # 工具类
│   │   │   └── websocket/        # WebSocket 处理
│   │   └── resources/
│   │       ├── application.properties
│   │       └── db/migration/    # Flyway 迁移脚本
│   └── test/
└── build.gradle.kts

配置说明

环境变量

• DB_USERNAME: 数据库用户名（默认: root）
• DB_PASSWORD: 数据库密码（默认: password）
• SERVER_PORT: 服务器端口（默认: 8000）
• CRYPTO_SECRET_KEY: 加密密钥（用于加密存储私钥和 API Key，建议设置）

application.properties

主要配置项：

• 数据库连接配置
• Polymarket API 地址配置
• WebSocket 地址配置

API 接口

市场相关

• POST /api/markets/list - 获取市场列表
• POST /api/markets/detail - 获取市场详情
• POST /api/markets/search - 搜索市场
• POST /api/markets/sports - 获取体育市场
• POST /api/markets/crypto - 获取加密货币市场

WebSocket

• WS /ws/polymarket - WebSocket 连接端点（转发到 Polymarket RTDS）

响应格式

所有接口统一返回以下格式：

{
  "code": 0,
  "data": {},
  "msg": ""
}

• code: 0 表示成功，非 0 表示失败
• data: 响应数据
• msg: 响应消息

错误码

• 0: 成功
• 1001-1999: 参数错误
• 2001-2999: 认证/权限错误
• 3001-3999: 资源不存在
• 4001-4999: 业务逻辑错误
• 5001-5999: 服务器内部错误

运行

# 构建项目
./gradlew build

# 运行应用
./gradlew bootRun

注意事项

1. 仅支持 Polymarket 平台
2. 仅支持 sports 和 crypto 两个分类
3. WebSocket 转发需要配置正确的 Polymarket RTDS 地址
4. 生产环境需要配置正确的 CORS 策略