← 返回 Skills 市场
tianyuwu

Cifang Fund Data

作者 tianyuwu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
84
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install cifang-fund-data
功能描述
获取A股场内基金（ETF、LOF）的历史行情、实时行情和收益率排行数据。使用次方量化API（需要API Key）获取基金列表、历史行情、实时行情和场内基金排行数据。当用户需要获取中国场内基金数据、分析ETF/LOF表现、查询基金历史价格、实时行情或进行金融数据分析时，请使用此技能。
使用说明 (SKILL.md)

A股场内基金数据获取技能

本技能帮助用户通过次方量化API获取中国A股场内基金（ETF、LOF）的历史行情、实时行情和收益率排行数据。该API需要有效的API Key进行认证。

快速开始

  1. 获取API Key：访问次方量化平台获取API Key
  2. 优先安全注入：优先通过 --api-key 参数或短期环境变量注入，避免写入长期共享配置
  3. 设置环境变量（可选）：将API Key设置为环境变量 CIFANG_API_KEY
  4. 使用技能：请求基金数据时，技能会自动使用API Key

安全检查清单

在启用真实 API 前，建议逐项确认：

  1. 密钥意愿确认：本技能运行依赖 CIFANG_API_KEY，请先确认你愿意提供该密钥。
  2. 来源验证：优先确认发行者身份、源码仓库和第三方评价；如信息不足，先在受控环境试运行。
  3. 网络与隐私确认：技能会将 x-api-key 随请求发送至 https://www.cifangquant.com，请确认你接受相关隐私与使用条款。
  4. 自动触发策略：若不希望代理自动执行，请在安装或代理策略中禁用/限制该技能自动触发。

API 端点

基础信息

  • 基础URL: https://www.cifangquant.com/api
  • 认证: 请求头 x-api-key: YOUR_API_KEY
  • 响应格式: 统一JSON格式 {"code": 0, "message": "ok", "data": ...}

可用接口

  1. 基金列表：GET /api/fund/list

    • 参数：key_word (可选，基金代码或名称)
    • 返回：基金基础信息列表

  2. 历史行情：GET /api/fund/hist_em

    • 参数：
      • symbol: 基金代码，多个以逗号分隔（最多50个）
      • start_date: 开始日期 YYYY-MM-DD
      • end_date: 结束日期 YYYY-MM-DD
      • adjust: 复权类型 none(不复权)/qfq(前复权)/hfq(后复权)，默认none

  3. 实时行情：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(行情时间)

  4. 场内基金排行：GET /api/fund/exchange_rank

    • 参数：
      • sort_by: 排序字段：zzf(近1周)、1yzf(近1月)、3yzf(近3月)、6yzf(近6月)、1nzf(近1年)、2nzf(近2年)、3nzf(近3年)、jnzf(今年来)、lnzf(成立以来)，默认1yzf
      • sort_order: 排序方向：desc(降序)或asc(升序)，默认desc
      • limit: 返回数量上限，默认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 是否设置。如果未设置，提示用户：

  1. 访问 https://www.cifangquant.com 获取API Key
  2. 设置环境变量：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错误响应
  • 数据完整性检查

错误处理

常见错误

  1. 401 Unauthorized：API Key无效或未提供
  2. 400 Bad Request：参数格式错误
  3. 404 Not Found：基金代码不存在
  4. 429 Too Many Requests：请求频率超限

错误恢复

  • 提示用户检查API Key
  • 建议合理的日期范围
  • 提供基金代码格式示例
  • 建议降低请求频率

使用示例

示例1：获取单只基金历史数据

用户请求："获取沪深300ETF（510300）2023年的历史数据"

技能操作：

  1. 解析基金代码：510300
  2. 设置日期范围：2023-01-01 到 2023-12-31
  3. 调用历史行情接口
  4. 转换数据格式并输出

示例2：查找基金

用户请求："查找所有沪深300相关的ETF"

技能操作：

  1. 使用关键词"沪深300"调用基金列表接口
  2. 过滤ETF类型基金
  3. 返回匹配的基金列表

示例3：多基金比较

用户请求："比较510300和510500过去一年的表现"

技能操作：

  1. 解析多个基金代码：510300,510500
  2. 设置日期范围：过去一年
  3. 批量获取历史数据
  4. 计算比较指标并输出

示例4：获取实时行情

用户请求："获取国投白银LOF（161226）和黄金ETF（518880）的实时行情"

技能操作：

  1. 解析基金代码：161226,518880
  2. 调用实时行情接口
  3. 返回实时行情快照，包含最新价、涨跌幅、成交量等字段

示例5：获取基金排行

用户请求："获取近1月收益率最高的前10只场内基金"

技能操作：

  1. 设置排序字段：1yzf（近1月收益率）
  2. 设置排序方向：desc（降序）
  3. 设置返回数量：10
  4. 调用场内基金排行接口
  5. 返回排行榜数据，包含排名、基金代码、收益率等字段

注意事项

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。

安全使用建议
This skill appears to be what it says: a client for 次方量化's fund-data API. Before installing: 1) Note the inconsistency — the registry metadata omits required env vars but SKILL.md and the scripts require CIFANG_API_KEY; expect to provide that API key. 2) Only provide the API key if you trust https://www.cifangquant.com and are comfortable with the provider's terms/privacy; the key will be sent as x-api-key to that domain. 3) Test first with the included mock_data.py (no real key) or run the scripts locally with --api-key to confirm behavior. 4) If you do not want the agent to call the API autonomously, disable/limit automatic invocation in your agent policies. 5) Verify the publisher/source (homepage and repository) if you need stronger provenance, and correct the registry metadata discrepancy before relying on automated tooling that reads those fields.
功能分析
Type: OpenClaw Skill Name: cifang-fund-data Version: 1.0.1 The skill bundle is a legitimate tool for fetching A-share fund data (ETF/LOF) from the Cifang Quant API (cifangquant.com). The Python implementation in `scripts/fetch_fund_data.py` uses standard libraries to perform authenticated HTTP requests to the documented service, and the `SKILL.md` instructions are well-aligned with the stated purpose, even including proactive safety checklists for the agent to follow.
能力标签
cryptocan-make-purchasesrequires-sensitive-credentials
能力评估
ℹ Purpose & Capability
The name, description, SKILL.md, and included Python scripts all focus on fetching A-share ETF/LOF data from 次方量化 (cifangquant) and use the x-api-key header. That capability is coherent. However the registry metadata lists no required env vars or primary credential while SKILL.md and scripts explicitly require CIFANG_API_KEY — this metadata omission is inconsistent and should be corrected.
✓ Instruction Scope
Runtime instructions only describe building HTTP GET requests to cifangquant endpoints, reading CIFANG_API_KEY (or accepting --api-key), parsing JSON, converting arrays to objects and computing simple stats. There are no instructions to read unrelated files, access other credentials, or transmit data to unexpected endpoints.
✓ Install Mechanism
There is no remote install or download step (instruction-only with bundled scripts). All code is included in the package; no external archives, URL downloads, or package registry installs are requested.
ℹ Credentials
The only secret required is CIFANG_API_KEY, which is proportionate to the declared purpose. The concern is the registry metadata claiming 'Required env vars: none' while SKILL.md and fetch_fund_data.py clearly require CIFANG_API_KEY — this discrepancy could mislead users about what to provide and about where secrets will be sent.
✓ Persistence & Privilege
The skill does not request always:true, does not modify other skills or global config, and will only act when invoked (autonomous invocation is platform default). No elevated persistence or cross-skill access is requested.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install cifang-fund-data
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /cifang-fund-data 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- 新增 LICENSE 文件，补充开源和使用协议信息。 - SKILL.md 增加 homepage 字段，指向官方API页面。 - SKILL.md 增加 required_env_vars 字段，明确需设置 CIFANG_API_KEY。 - 新增“安全检查清单”板块，提醒用户密钥安全、隐私和自动触发风险。 - 快速开始部分建议优先临时注入 API Key，减少长期风险。
v1.0.0
Initial release of cifang-fund-data skill. - Enables access to historical data, real-time quotes, and yield rankings for A-share ETFs/LOFs on the China market via Cifang Quantitative API. - Supports searching funds, retrieving fund lists, querying and comparing historical/real-time performance, and ranking funds by various yield periods. - Includes data conversion from array to readable format, basic statistics calculation, and robust error handling for API responses. - Requires user to provide a valid API Key via environment variable `CIFANG_API_KEY`. - Provides scripts for data fetching, conversion, and statistics calculation.
元数据
Slug cifang-fund-data
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Cifang Fund Data 是什么？

获取A股场内基金（ETF、LOF）的历史行情、实时行情和收益率排行数据。使用次方量化API（需要API Key）获取基金列表、历史行情、实时行情和场内基金排行数据。当用户需要获取中国场内基金数据、分析ETF/LOF表现、查询基金历史价格、实时行情或进行金融数据分析时，请使用此技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 84 次。

如何安装 Cifang Fund Data？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cifang-fund-data」即可一键安装，无需额外配置。

Cifang Fund Data 是免费的吗？

是的，Cifang Fund Data 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Cifang Fund Data 支持哪些平台？

Cifang Fund Data 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Cifang Fund Data？

由 tianyuwu（@tianyuwu）开发并维护，当前版本 v1.0.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论