# stock-data-puller

**Repository Path**: lucaszz/stock-data-puller

## Basic Information

- **Project Name**: stock-data-puller
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-19
- **Last Updated**: 2025-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 股票数据拉取服务

这是一个基于Spring## 功能介绍

- 定时从必盈数据API拉取股票数据
- 提供RESTful API接口查询股票数据
- 支持多种股票数据类型：基础信息、涨停股池、跌停股池、强势股池、炸板股池、历史分时数据

## 技术栈

- Spring Boot 2.7.0
- MySQL 5.7
- MyBatis-Plus 3.5.1
- Hutool 5.8.11
- FastJSON 1.2.83

## 配置说明

### 数据库配置

在 `application-dev.yml` 中配置数据库连接信息：

```yaml
spring:
  datasource:
    host: localhost
    port: 3306
    database: a_stock
    username: root
    password: 123456
```

### 必盈数据配置

在 `application.yml` 中配置必盈数据API信息：

```yaml
biying:
  api:
    licence: your_licence_here
    base-url: http://api.biyingapi.com
    stock-list-url: ${biying.api.base-url}/hslt/list/${biying.api.licence}
    limit-up-url: ${biying.api.base-url}/hslt/ztgc/{date}/${biying.api.licence}
    limit-down-url: ${biying.api.base-url}/hslt/dtgc/{date}/${biying.api.licence}
    bull-url: ${biying.api.base-url}/hslt/qsgc/{date}/${biying.api.licence}
    boom-url: ${biying.api.base-url}/hslt/zbgc/{date}/${biying.api.licence}
    history-url: https://api.biyingapi.com/hsstock/history/{stockCode}/{level}/{adjust}/{biying.api.licence}
```

### 定时任务配置

在 `application.yml` 中配置定时任务执行时间：

```yaml
scheduling:
  stock:
    cron: 0 0 18 * * ?
```

## 数据库表结构

项目包含以下表结构：

- `stock_base_info` - 股票基础信息表
- `stock_limit_up_info` - 股票涨停信息表
- `stock_limit_down_info` - 股票跌停信息表
- `stock_bull_info` - 强势股信息表
- `stock_limit_boom_info` - 股票炸板信息表
- `stock_day_data` - A股日线历史数据表

详细表结构请参考 `sql` 目录下的文件。

## API接口

### 获取所有股票基础信息

```
GET /api/stock/base-info
```

### 根据日期获取涨停股池

```
GET /api/stock/limit-up/{date}
```

### 根据日期获取跌停股池

```
GET /api/stock/limit-down/{date}
```

### 根据日期获取强势股池

```
GET /api/stock/bull/{date}
```

### 根据日期获取炸板股池

```
GET /api/stock/limit-boom/{date}
```

### 根据股票代码和日期范围获取历史分时数据

```
GET /api/stock/day-data/{stockCode}/{startDate}/{endDate}
```

## 使用说明

1. 配置数据库连接信息
2. 配置必盈数据API许可证
3. 启动应用，定时任务会在每天下午18点自动拉取数据
4. 通过API接口查询股票数据

## 注意事项

1. 请确保必盈数据API许可证有效
2. 历史分时数据拉取可能需要较长时间，建议在非交易时间执行
3. 请根据实际情况调整定时任务执行时间