fund-market-research

# 基金市场研究 (Fund Market Research)

基金市场全景分析与趋势研究工具，提供全面的基金市场数据和趋势洞察。

## 功能概述

- **市场规模统计**: 基金数量、总规模、各类别分布
- **新发基金追踪**: 新发行基金统计、募集情况、发行趋势
- **资金流向分析**: 申购/赎回数据、资金净流入/流出
- **热门板块追踪**: 行业主题基金热度、板块轮动
- **收益分布分析**: 基金收益率分布、业绩排名
- **市场情绪指标**: 基金发行热度、投资者情绪指数
- **基金发行日历**:  upcoming新发基金、募集期提醒

## 使用方法

### 命令行调用

```bash
# 市场概览
fund-market --overview

# 查看资金流向
fund-market --flow --period 30d

# 热门板块
fund-market --hot-sectors

# 发行日历
fund-market --calendar --days 30

# 收益分布
fund-market --returns-dist --type 股票型
```

### Python API

```python
from fund_market_research import FundMarketResearch

research = FundMarketResearch()

# 市场概览
overview = research.get_overview()

# 资金流向
flow = research.get_fund_flow(days=30)

# 热门板块
sectors = research.get_hot_sectors()
```

## 输出格式

### 市场概览报告

```json
{
  "report_date": "2026-03-21",
  "market_overview": {
    "total_funds": 11580,
    "total_scale": 28.5,
    "scale_unit": "万亿",
    "categories": {
      "equity": {"count": 3200, "scale": 8.2, "avg_return_ytd": 5.2},
      "hybrid": {"count": 4100, "scale": 6.8, "avg_return_ytd": 3.8},
      "bond": {"count": 2800, "scale": 9.5, "avg_return_ytd": 1.5},
      "money": {"count": 800, "scale": 3.2, "avg_return_ytd": 0.8},
      "qdii": {"count": 400, "scale": 0.6, "avg_return_ytd": 8.5},
      "index": {"count": 280, "scale": 0.2, "avg_return_ytd": 4.2}
    }
  },
  "market_trends": {
    "new_funds_30d": 45,
    "total_raising": 1200.5,
    "net_inflow": -85.3,
    "sentiment_index": 52.5
  }
}
```

## 市场指标说明

### 市场规模指标

| 指标 | 说明 | 数据来源 |
|:---|:---|:---|
| **基金总数** | 全市场公募基金数量 | 中基协 |
| **管理规模** | 公募基金总规模（万亿） | 中基协 |
| **类别分布** | 股票/混合/债券/货币/QDII/指数 | 分类统计 |
| **规模变化** | 环比/同比规模变化 | 月度数据 |

### 资金流向指标

| 指标 | 说明 | 计算方式 |
|:---|:---|:---|
| **净流入** | 申购-赎回的净额 | 正=流入，负=流出 |
| **流入占比** | 流入金额/总规模 | 反映市场热度 |
| **分类流向** | 各类型基金资金流向 | 权益/固收分别统计 |
| **渠道分布** | 直销/银行/券商/第三方 | 销售渠道分析 |

### 热门板块追踪

| 板块 | 追踪指标 | 热度计算 |
|:---|:---|:---|
| **行业主题** | 科技/医药/消费/新能源 | 相关基金数量和规模 |
| **风格主题** | 价值/成长/红利 | 风格基金表现 |
| **区域主题** | 港股/美股/新兴市场 | QDII资金流向 |
| **策略主题** | 量化/ESG/FOF | 策略基金热度 |

## 基金发行日历

### 日历信息

```json
{
  "upcoming_funds": [
    {
      "fund_code": "待公布",
      "fund_name": "XX科技创新混合",
      "fund_type": "混合型",
      "manager": "张三",
      "company": "XX基金",
      "start_date": "2026-03-25",
      "end_date": "2026-04-15",
      "target_scale": "50亿",
      "investment_theme": "科技创新"
    }
  ]
}
```

### 发行趋势

- **月度发行数量**: 统计每月新发基金数量
- **募集规模分布**: 百亿基金、清盘基金统计
- **发行成功率**: 成立基金/申报基金比例

## 示例

### 示例1: 市场概览

**输入**:
```
查看基金市场概览
```

**输出**:
```
📊 2026年3月21日 基金市场概览

市场规模:
  基金总数: 11,580只
  管理规模: 28.50万亿
  较上月: +0.35万亿 (+1.2%)

类别分布:
  股票型: 3,200只 | 8.20万亿 | 年内收益 +5.2%
  混合型: 4,100只 | 6.80万亿 | 年内收益 +3.8%
  债券型: 2,800只 | 9.50万亿 | 年内收益 +1.5%
  货币型:   800只 | 3.20万亿 | 年内收益 +0.8%
  QDII  :   400只 | 0.60万亿 | 年内收益 +8.5%
  指数型:   280只 | 0.20万亿 | 年内收益 +4.2%

市场趋势:
  近30天新发基金: 45只
  募集资金: 1,200.5亿
  资金净流入: -85.3亿
  市场情绪指数: 52.5 (中性)
```

### 示例2: 资金流向分析

**输入**:
```
查看近30天资金流向
```

**输出**:
```
💰 近30天资金流向分析

总体流向:
  资金净流入: -85.3亿
  流入基金: 3,200只
  流出基金: 4,500只

分类流向:
  股票型: -120.5亿 (权益市场调整)
  混合型: -45.2亿
  债券型: +65.8亿 (避险需求)
  货币型: +15.3亿
  QDII  : -0.7亿

热门流入:
  1. 招商中证白酒: +12.5亿
  2. 易方达蓝筹精选: +8.3亿
  3. 天弘余额宝: +5.2亿

热门流出:
  1. 华夏成长混合: -15.2亿
  2. 富国天惠成长: -12.8亿
  3. 嘉实沪深300: -10.5亿
```

### 示例3: 热门板块追踪

**输入**:
```
查看热门板块
```

**输出**:
```
🔥 热门板块追踪 (2026-03-21)

行业主题热度:
  排名 板块          相关基金  规模(亿)  近30天收益  热度
  1    白酒           45只     1,250    +8.5%      🔥🔥🔥
  2    新能源         68只     2,180    +6.2%      🔥🔥🔥
  3    医药生物       52只     1,680    +4.8%      🔥🔥
  4    科技(TMT)      78只     1,920    +3.5%      🔥🔥
  5    消费           35只       980    +2.8%      🔥

风格主题热度:
  成长风格: 🔥🔥🔥 热度指数 78.5
  价值风格: 🔥      热度指数 42.3
  红利策略: 🔥🔥    热度指数 58.6

区域主题热度:
  港股: 🔥🔥 近30天流入 +25.3亿
  美股: 🔥   近30天流出 -8.5亿
  新兴市场: 🔥 近30天流入 +3.2亿
```

## 注意事项

1. 市场数据基于公开信息，存在一定滞后性
2. 资金流向为估算数据，仅供参考
3. 市场情绪指数基于多因子综合计算
4. 基金发行日历信息以基金公司公告为准
5. 热门板块追踪基于基金持仓和申赎数据估算

## 依赖

```
pandas>=1.3.0
numpy>=1.20.0
requests>=2.25.0
```

## 作者

FinClaw - 上海财经大学金融研究工具