A股场内基金数据获取技能
本技能帮助用户通过次方量化API获取中国A股场内基金（ETF、LOF）的历史行情、实时行情和收益率排行数据。该API需要有效的API Key进行认证。
快速开始
- 获取API Key：访问次方量化平台获取API Key
- 优先安全注入：优先通过
--api-key 参数或短期环境变量注入，避免写入长期共享配置
- 设置环境变量（可选）：将API Key设置为环境变量
CIFANG_API_KEY
- 使用技能：请求基金数据时，技能会自动使用API Key
安全检查清单
在启用真实 API 前，建议逐项确认：
- 密钥意愿确认：本技能运行依赖
CIFANG_API_KEY，请先确认你愿意提供该密钥。
- 来源验证：优先确认发行者身份、源码仓库和第三方评价；如信息不足，先在受控环境试运行。
- 网络与隐私确认：技能会将
x-api-key 随请求发送至 https://www.cifangquant.com，请确认你接受相关隐私与使用条款。
- 自动触发策略：若不希望代理自动执行，请在安装或代理策略中禁用/限制该技能自动触发。
API 端点
基础信息
- 基础URL:
https://www.cifangquant.com/api
- 认证: 请求头
x-api-key: YOUR_API_KEY
- 响应格式: 统一JSON格式
{"code": 0, "message": "ok", "data": ...}
可用接口
-
基金列表：GET /api/fund/list
- 参数：
key_word (可选，基金代码或名称)
- 返回：基金基础信息列表
-
历史行情：GET /api/fund/hist_em
- 参数：
symbol: 基金代码，多个以逗号分隔（最多50个）start_date: 开始日期 YYYY-MM-DDend_date: 结束日期 YYYY-MM-DDadjust: 复权类型 none(不复权)/qfq(前复权)/hfq(后复权)，默认none
-
实时行情：GET /api/fund/spot
- 参数：
symbol: 基金代码；支持多个代码用英文逗号 , 分隔，不传则返回全量实时行情
- 返回：基金实时行情快照，数据延迟通常不超过2分钟
- 字段：
code(基金代码), name(基金名称), price(最新价), change(涨跌幅%), change_amount(涨跌额), volume(成交量), amount(成交额), open(开盘价), high(最高价), low(最低价), close_yesterday(昨收价), fund_type(基金类型), trade_date(交易日期), data_time(行情时间)
-
场内基金排行：GET /api/fund/exchange_rank
- 参数：
sort_by: 排序字段：zzf(近1周)、1yzf(近1月)、3yzf(近3月)、6yzf(近6月)、1nzf(近1年)、2nzf(近2年)、3nzf(近3年)、jnzf(今年来)、lnzf(成立以来)，默认1yzfsort_order: 排序方向：desc(降序)或asc(升序)，默认desclimit: 返回数量上限，默认30000
- 返回：场内基金收益率排行榜
- 字段：
rank(排名), fund_code(基金代码), fund_name(基金名称), fund_type(基金类型), date(净值日期), unit_nav(单位净值), accumulated_nav(累计净值), week_1(近1周收益率), month_1(近1月收益率), month_3(近3月收益率), month_6(近6月收益率), year_1(近1年收益率), year_2(近2年收益率), year_3(近3年收益率), ytd(今年来收益率), since_inception(成立以来收益率), inception_date(成立日期)
使用指南
1. 获取基金列表
当用户需要查找特定基金或浏览可用基金时，使用基金列表接口。
示例请求：
curl -H "x-api-key: $CIFANG_API_KEY" \
"https://www.cifangquant.com/api/fund/list?key_word=510300"
响应示例：
[
{
"fund_code": "510300",
"fund_name": "华泰柏瑞沪深300ETF",
"fund_type": "指数型-股票",
"fund_market": "SH",
"establish_date": "2012-05-04"
}
]
2. 获取历史行情
当用户需要基金的历史价格数据时，使用历史行情接口。
示例请求：
curl -H "x-api-key: $CIFANG_API_KEY" \
"https://www.cifangquant.com/api/fund/hist_em?symbol=510300,510500&start_date=2024-01-01&end_date=2024-12-31&adjust=qfq"
响应格式：
{
"510300": [
["2024-01-02", 3.45, 3.48, 3.50, 3.44, 1.23, 1000000],
["2024-01-03", 3.48, 3.50, 3.52, 3.47, 0.57, 1200000]
],
"510500": [
["2024-01-02", 5.67, 5.70, 5.72, 5.65, 0.53, 800000],
["2024-01-03", 5.70, 5.68, 5.72, 5.66, -0.35, 750000]
]
}
数据字段说明：
- 索引0: 日期 (YYYY-MM-DD)
- 索引1: 开盘价
- 索引2: 收盘价
- 索引3: 最高价
- 索引4: 最低价
- 索引5: 涨跌幅 (%)
- 索引6: 成交量
3. 获取实时行情
当用户需要获取场内基金的实时行情快照时，使用实时行情接口。该接口数据延迟通常不超过2分钟。
示例请求：
curl -H "x-api-key: $CIFANG_API_KEY" \
"https://www.cifangquant.com/api/fund/spot?symbol=161226,518880"
响应示例：
{
"161226": {
"code": "161226",
"name": "国投白银LOF",
"price": 2.73,
"change": -4.177,
"change_amount": -0.119,
"volume": 133505376,
"amount": 366382936,
"open": 2.789,
"high": 2.792,
"low": 2.716,
"close_yesterday": 2.849,
"fund_type": "LOF",
"trade_date": "2026-04-23T00:00:00Z",
"data_time": "13:32:33"
}
}
4. 获取场内基金排行
当用户需要查看场内基金的收益率排行榜时，使用场内基金排行接口。支持按不同时间区间的收益率排序。
示例请求：
curl -H "x-api-key: $CIFANG_API_KEY" \
"https://www.cifangquant.com/api/fund/exchange_rank?sort_by=1yzf&sort_order=desc&limit=100"
响应示例：
[
{
"rank": 1,
"fund_code": "515880",
"fund_name": "通信ETF国泰",
"fund_type": "指数型-股票",
"date": "2026-04-22",
"unit_nav": 1.4105,
"accumulated_nav": 4.2315,
"week_1": 15.52,
"month_1": 30.87,
"month_3": 33.43,
"month_6": 58.25,
"year_1": 270.6,
"year_2": 282.98,
"year_3": 279.1,
"ytd": 37.28,
"since_inception": 323.19,
"inception_date": "2019-08-16"
}
]
技能工作流程
步骤1：检查API Key
首先检查环境变量 CIFANG_API_KEY 是否设置。如果未设置，提示用户：
- 访问 https://www.cifangquant.com 获取API Key
- 设置环境变量：
export CIFANG_API_KEY="your-api-key"
步骤2：解析用户请求
根据用户请求确定需要的数据：
- 基金查找：使用基金列表接口
- 历史数据：使用历史行情接口
- 实时行情：使用实时行情接口
- 基金排行：使用场内基金排行接口
- 多基金比较：支持多个基金代码
步骤3：构建API请求
根据用户需求构建相应的API请求：
- 基金列表：确定关键词（可选）
- 历史行情：确定基金代码（支持多个）、日期范围（默认最近一年）、复权类型（默认不复权）
- 实时行情：确定基金代码（支持多个，不传则返回全量）
- 基金排行：确定排序字段（默认近1月收益率）、排序方向（默认降序）、返回数量上限（默认30000）
步骤4：处理响应
将API响应转换为用户友好的格式：
- 解析JSON响应
- 转换数据格式（数组→对象）
- 添加元数据（基金名称、类型等）
- 计算衍生指标（累计收益率、波动率等）
步骤5：输出结果
以结构化JSON格式输出，包含：
- 基金基本信息
- 历史行情数据
- 统计摘要
- 数据质量说明
高级功能
1. 数据转换
将API返回的数组格式转换为更易读的对象格式：
原始格式：
["2024-01-02", 3.45, 3.48, 3.50, 3.44, 1.23, 1000000]
转换后格式：
{
"date": "2024-01-02",
"open": 3.45,
"close": 3.48,
"high": 3.50,
"low": 3.44,
"change_percent": 1.23,
"volume": 1000000
}
2. 统计计算
自动计算基本统计指标：
- 期间收益率
- 年化收益率
- 波动率
- 最大回撤
- 夏普比率（如提供无风险利率）
3. 数据验证
- 检查日期范围有效性
- 验证基金代码格式
- 处理API错误响应
- 数据完整性检查
错误处理
常见错误
- 401 Unauthorized：API Key无效或未提供
- 400 Bad Request：参数格式错误
- 404 Not Found：基金代码不存在
- 429 Too Many Requests：请求频率超限
错误恢复
- 提示用户检查API Key
- 建议合理的日期范围
- 提供基金代码格式示例
- 建议降低请求频率
使用示例
示例1：获取单只基金历史数据
用户请求："获取沪深300ETF（510300）2023年的历史数据"
技能操作：
- 解析基金代码：510300
- 设置日期范围：2023-01-01 到 2023-12-31
- 调用历史行情接口
- 转换数据格式并输出
示例2：查找基金
用户请求："查找所有沪深300相关的ETF"
技能操作：
- 使用关键词"沪深300"调用基金列表接口
- 过滤ETF类型基金
- 返回匹配的基金列表
示例3：多基金比较
用户请求："比较510300和510500过去一年的表现"
技能操作：
- 解析多个基金代码：510300,510500
- 设置日期范围：过去一年
- 批量获取历史数据
- 计算比较指标并输出
示例4：获取实时行情
用户请求："获取国投白银LOF（161226）和黄金ETF（518880）的实时行情"
技能操作：
- 解析基金代码：161226,518880
- 调用实时行情接口
- 返回实时行情快照，包含最新价、涨跌幅、成交量等字段
示例5：获取基金排行
用户请求："获取近1月收益率最高的前10只场内基金"
技能操作：
- 设置排序字段：
1yzf（近1月收益率）
- 设置排序方向：
desc（降序）
- 设置返回数量：10
- 调用场内基金排行接口
- 返回排行榜数据，包含排名、基金代码、收益率等字段
注意事项
1. API限制
- 需要有效的API Key（VIP会员）
- 历史行情接口最多支持50个基金代码
- 实时行情接口支持全量返回，但数据延迟通常不超过2分钟
- 场内基金排行接口默认返回30000条记录，可通过
limit参数调整
- 请求频率限制（未在文档中明确）
2. 数据质量
- 数据来源：东方财富等公开数据
- 历史行情更新频率：交易日收盘后更新
- 实时行情更新频率：交易日内实时更新，数据延迟通常不超过2分钟
- 复权数据：支持前复权(qfq)和后复权(hfq)
3. 使用建议
- 对于长期分析，建议使用前复权数据
- 批量请求时注意代码数量限制
- 合理设置日期范围避免过大数据量
扩展支持
实时行情
API现已提供实时行情接口，支持获取场内基金的实时行情快照：
- 数据延迟通常不超过2分钟
- 支持单个或多个基金代码查询
- 包含最新价、涨跌幅、成交量等关键字段
- 可全量返回所有基金的实时行情
数据导出
支持将数据导出为多种格式：
- JSON（默认）
- CSV（用于Excel）
- Pandas DataFrame（Python分析）
脚本工具
技能目录下的 scripts/ 文件夹包含辅助脚本：
fetch_fund_data.py：封装API调用的Python脚本convert_format.py：数据格式转换工具calculate_stats.py：统计指标计算工具
使用这些脚本可以简化数据处理流程。
重要：使用本技能需要有效的次方量化API Key。请确保已设置环境变量 CIFANG_API_KEY。
