117 lines
2.8 KiB
Markdown
117 lines
2.8 KiB
Markdown
|
# 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）
|
|||
|
|
|
|||
|
|
## 响应格式
|
|||
|
|
|
|||
|
|
所有接口统一返回以下格式：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"data": {},
|
|||
|
|
"msg": ""
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- `code`: 0 表示成功，非 0 表示失败
|
|||
|
|
- `data`: 响应数据
|
|||
|
|
- `msg`: 响应消息
|
|||
|
|
|
|||
|
|
## 错误码
|
|||
|
|
|
|||
|
|
- `0`: 成功
|
|||
|
|
- `1001-1999`: 参数错误
|
|||
|
|
- `2001-2999`: 认证/权限错误
|
|||
|
|
- `3001-3999`: 资源不存在
|
|||
|
|
- `4001-4999`: 业务逻辑错误
|
|||
|
|
- `5001-5999`: 服务器内部错误
|
|||
|
|
|
|||
|
|
## 运行
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 构建项目
|
|||
|
|
./gradlew build
|
|||
|
|
|
|||
|
|
# 运行应用
|
|||
|
|
./gradlew bootRun
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 仅支持 Polymarket 平台
|
|||
|
|
2. 仅支持 `sports` 和 `crypto` 两个分类
|
|||
|
|
3. WebSocket 转发需要配置正确的 Polymarket RTDS 地址
|
|||
|
|
4. 生产环境需要配置正确的 CORS 策略
|
|||
|
|
|