# AI Stock Trading Assistant (模拟量化交易系统)

这是一个基于 Python 的简易量化交易模拟系统。它能够自动抓取美股实时行情，根据预设策略进行分析，并模拟执行交易（记录日志）。

## 功能特点

*   **数据抓取**: 集成东方财富 API 和富途牛牛网页解析，获取美股实时价格和涨跌幅。
*   **自动监控**: `monitor.py` 支持循环扫描市场，实时监控股票动态。
*   **策略分析**: 内置简单的趋势跟踪策略（涨跌幅阈值），可扩展接入大模型分析。
*   **模拟交易**: 生成交易信号并记录到 CSV 日志，不涉及真实资金操作。

## 环境要求

*   Python 3.6+
*   依赖库:
    *   `requests`
    *   `beautifulsoup4`

## 安装

1.  克隆或下载本项目。
2.  安装所需的 Python 库：

```bash
pip install requests beautifulsoup4
```

## 使用指南

### 1. 启动自动监控系统

运行 `monitor.py` 启动全自动监控循环。系统会定期抓取数据、分析并记录交易信号。

```bash
# 默认启动 (监控 Top 100 股票，间隔 60 秒)
python monitor.py

# 自定义监控间隔 (例如 30 秒)
python monitor.py --interval 30

# 监控更多股票 (例如 Top 200)
python monitor.py --limit 200

# 全量监控 (速度较慢，获取所有美股数据)
python monitor.py --all
```
python monitor.py --limit 10 --interval 5 --premarket --premarket-limit 3
运行后，交易记录将实时写入 `trade_log.csv` 文件。

### 2. 单独使用数据抓取工具

`futu.py` 可以作为独立工具运行，用于抓取数据并保存为 CSV。

```bash
# 获取美股市值前 50 名股票数据
python futu.py --top50

# 获取前 100 名并保存到文件
python futu.py --top50 --limit 100 --output stocks.csv

# 仅使用东方财富数据源 (速度更快)
python futu.py --top50 --eastmoney-only
```
python premarket_watch.py --limit 10 --force
## 项目结构

*   `monitor.py`: **主程序**。负责调度数据抓取、分析和交易模块，执行循环监控。
*   `futu.py`: **数据层**。包含 `EastMoneyAPI` 和 `FutuStockParser`，负责从网络获取股票数据。
*   `market_analyzer.py`: **策略层**。接收行情数据，根据策略（如涨跌幅 > 5%）生成买卖信号。
*   `trader.py`: **执行层**。接收信号，模拟下单过程，并将结果写入日志。
*   `trade_log.csv`: **日志文件**。记录所有模拟交易的历史数据。

## 免责声明

本项目仅供学习和研究使用。系统中的“交易”均为模拟行为，不涉及任何真实资金往来。投资有风险，入市需谨慎。