# GETF

**Repository Path**: yiluda/getf

## Basic Information

- **Project Name**: GETF
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黄金20日年化波动率分析模块

## 项目概述
本模块用于计算黄金的20日年化波动率，并依据预设阈值将其划分为【低/中/高】三个风险等级，最终生成标准化的波动率计算报告。

## 文件结构
```
.
├── gold_volatility.py    # 核心模块（波动率计算和数据获取
├── main.py                # 主程序入口和使用示例
└── requirements.txt      # 项目依赖
└── README.md          # 使用说明文档
```

## 核心类说明

### GoldVolatilityAnalyzer
黄金波动率分析器，负责数据预处理、计算波动率、划分等级和生成报告。

**主要方法**：
- `calculate_volatility(prices, start_date, end_date, source)
  - 计算20日年化波动率
  - 参数：
    - prices: 20个连续交易日的收盘价列表
    - start_date: 数据起始日期 (可选)
    - end_date: 数据结束日期 (可选)
    - source: 数据来源 (默认"用户提供"

- `generate_report(result)
  - 生成标准化的波动率计算报告

### GoldDataFetcher
黄金数据获取器，负责从网络获取最新的黄金价格数据。

**主要方法**：
- `fetch_london_gold_prices()`: 获取伦敦金(GC=F)最近20个交易日的收盘价
- `fetch_huaan_gold_etf(): 获取华安黄金ETF(518880.SS)最近20个交易日的收盘价

## 波动率等级划分标准
- 低波动：年化波动率 < 15.00%
- 中波动：15.00% ≤ 年化波动率 ≤ 25.00%
- 高波动：年化波动率 > 25.00%

## 快速使用

### 1. 安装依赖
```bash
pip3 install -r requirements.txt
```

### 2. 使用用户提供的数据
```python
from gold_volatility import GoldVolatilityAnalyzer

analyzer = GoldVolatilityAnalyzer()
prices = [2320.50, 2315.80, ...]  # 20个连续交易日收盘价
result = analyzer.calculate_volatility(
    prices,
    start_date="2026-04-25",
    end_date="2026-05-22",
    source="用户提供"
)
report = analyzer.generate_report(result)
print(report)
```

### 3. 使用最新市场数据
```python
from gold_volatility import GoldVolatilityAnalyzer, GoldDataFetcher

analyzer = GoldVolatilityAnalyzer()
data_fetcher = GoldDataFetcher()
prices, start_date, end_date = data_fetcher.fetch_london_gold_prices()
result = analyzer.calculate_volatility(
    prices, start_date, end_date, source="yfinance金融数据平台"
)
report = analyzer.generate_report(result)
print(report)
```

### 4. 运行示例
```bash
python3 main.py
```

## 注意事项
- 确保Python 代码使用 python3 命令运行
- 需要安装依赖时，确保使用 pip3 命令
- 代码兼容云服务器部署