finance

市场追踪技能

此技能可帮助你获取以下内容的最新报价和历史序列：

• 股票 / ETF / 指数（例如，AAPL、MSFT、^GSPC、VOO）
• 外汇货币对（例如，USD/ZAR、EURUSD、GBP-JPY）
• 所选提供商支持的加密货币代码（尽力而为）

此技能针对以下场景进行了优化：

• 快速查询“现在的价格是多少？”
• 使用本地观察列表进行轻量级追踪
• 通过缓存避免触发速率限制

适用场景

当用户提出以下请求时，请使用此技能：

• “___ 的最新价格是多少？”
• “追踪 ___ 和 ___，并显示每日变动。”
• “提供 ___ 的 30 天序列。”
• “将 USD 兑换为 ZAR（或追踪 USD/ZAR）。”
• “维护观察列表并总结表现。”

提供商策略（重要）

• 股票 / ETF / 指数默认使用：通过 yfinance 获取 Yahoo Finance 数据（无需密钥，覆盖范围广），但它是非官方的，且可能触发速率限制。
• 外汇默认使用：ExchangeRate-API Open Access 端点（无需密钥，每日更新）。
• 如果用户需要高频数据或大量代码，建议之后添加付费提供商。

详情和代码格式请参阅 providers.md。

---

快速入门（运行方式）

这些脚本旨在通过终端运行。Agent 应：

1. 确保已安装依赖项
2. 运行脚本
3. 清晰地总结结果

安装：

• python -m venv .venv && source .venv/bin/activate（或使用 Windows 对应命令）
• pip install -r requirements.txt

命令

1) 最新报价（股票 / ETF / 指数）

示例：

• python scripts/market_quote.py AAPL
• python scripts/market_quote.py ^GSPC
• python scripts/market_quote.py VOO

2) 最新外汇汇率

示例：

• python scripts/market_quote.py USD/ZAR
• python scripts/market_quote.py EURUSD
• python scripts/market_quote.py GBP-JPY

3) 历史序列（CSV 输出到 stdout）

示例：

• python scripts/market_series.py AAPL --days 30
• python scripts/market_series.py USD/ZAR --days 30

4) 观察列表摘要（本地文件）

• 添加代码：python scripts/market_watchlist.py add AAPL MSFT USD/ZAR
• 移除：python scripts/market_watchlist.py remove MSFT
• 显示摘要：python scripts/market_watchlist.py summary

---

输出要求（应返回给用户的内容）

• 报价：价格、变动百分比、时间戳 / 来源，以及任何注意事项（例如“外汇每日更新”）。
• 序列：确认日期范围和数据点数量，并展示简短预览（前几行和后几行）。
• 如果触发速率限制：说明原因并使用退避策略重试，或建议降低请求频率。

---

安全性 / 正确性

• 除非提供商确实提供实时数据，否则绝不要声称数据是“实时的”。外汇开放访问端点每日更新。
• 始终缓存响应，并限制重复调用频率。
• 如果 Yahoo 屏蔽请求，建议使用付费提供商或延长缓存 TTL。