finance

核心功能

本 Skill 是一套基于 Python 的金融市场数据获取工具，通过命令行脚本提供实时报价与历史价格序列查询能力。支持资产类别涵盖股票、ETF、指数（如 AAPL、VOO、^GSPC）、外汇货币对（USD/ZAR、EURUSD）及部分加密货币，采用分层供应商策略：默认使用 Yahoo Finance（yfinance 库，免API密钥但非官方接口）获取权益类资产，ExchangeRate-API 免费端点处理外汇日频数据，同时预留 Twelve Data、Alpha Vantage 等付费服务商接入能力。

显著优点

• 零门槛快速启动：核心功能无需 API 密钥，Python 虚拟环境 + pip 安装即可运行
• 智能缓存机制：本地 .cache/finance 目录持久化存储，有效规避 Yahoo Finance 非官方接口的速率限制
• 供应商容错设计：内置多供应商回退逻辑，单点故障时可切换至备用数据源
• 本地化观察清单：market_watchlist.py 支持持久化持仓组合，一键生成组合表现摘要

局限性与风险

• 数据时效性限制：免费外汇数据源为日频更新，Yahoo Finance 存在 15-20 分钟延迟，严禁声称"实时"
• 非官方接口脆弱性：yfinance 依赖 Yahoo 未公开 API，存在无预警封锁或结构变更风险
• 高频场景不适用：大量标的同时查询或高频轮询易触发限流，需升级至付费供应商
• 加密货币覆盖有限：依赖供应商支持情况，标注为"尽力而为"(best-effort)

适用人群

个人投资者、小型资管团队、量化研究初学者，需低成本获取日频/延迟行情用于持仓监控或策略回测，不适合高频交易或毫秒级决策场景。

安全建议

• 生产环境建议配置付费 API 密钥替代 Yahoo Finance
• 设置合理缓存 TTL（建议 ≥5 分钟），避免重复请求
• 敏感持仓数据存储于本地 watchlist 文件，注意文件权限管理

核心用法

finance 是一款轻量级市场数据追踪 Skill，专为终端用户设计，支持股票、ETF、指数、外汇对及加密货币的价格查询与历史数据分析。

功能模块

1. 实时行情查询 (market_quote.py)

• 股票/ETF/指数：默认通过 Yahoo Finance API 获取
• 外汇对：使用 ExchangeRate-API 开放端点
• 支持多种符号格式：AAPL、^GSPC、USD/ZAR、EURUSD 等

2. 历史数据导出 (market_series.py)

• 输出 CSV 格式时间序列数据
• 可自定义回溯天数（默认 30 天）

3. 本地观察清单 (market_watchlist.py)

• 增删自选股/外汇对
• 一键生成多资产绩效摘要

显著优点

• 零配置开箱即用：无需 API 密钥即可获取基础数据
• 智能缓存机制：股票数据缓存 60 秒，外汇数据缓存 12 小时，有效规避速率限制
• 多源回退设计：预留 Twelve Data、Alpha Vantage 等付费接口扩展
• 隐私优先：不收集用户敏感信息，可选密钥通过环境变量注入

潜在局限与风险

| 局限 | 说明 |

|------|------|

| 非官方数据源 | Yahoo Finance 为逆向工程接口，存在服务不稳定或被屏蔽风险 |

| 外汇更新频率 | 免费 ExchangeRate-API 仅每日更新，非实时汇率 |

| 高频限制 | 大量符号查询可能触发 IP 限流，需依赖付费方案 |

| 模块通信方式 | 当前使用 subprocess 调用同目录脚本，存在性能开销 |

适合人群

• 个人投资者进行日常持仓监控
• 开发者构建轻量级金融数据原型
• 需要离线缓存能力的低频查询场景

常规风险管控

• 严格区分"实时"与"延迟"数据声明
• 缓存目录定期清理防止磁盘膨胀
• 建议生产环境配置付费 API 密钥以获得 SLA 保障