核心用法
Quodd Stock Quotes 是一个基于 Python 的命令行工具,用于通过 Quodd 官方 API 获取美国股市的实时股票报价。核心功能包括:
- 单股查询:
python scripts/quote.py AAPL快速获取单只股票的最新价格 - 批量查询:支持一次传入多个 ticker,如
AAPL MSFT META GOOGL,适合投资组合监控 - 双格式输出:默认文本表格便于快速阅读,
--format json提供结构化数据便于程序处理 - 盘后数据:独特提供 after-hours(盘后交易)时间和价格,覆盖完整交易时段
显著优点
1. 数据源权威性:直接对接 Quodd 官方 API,非第三方抓取,数据延迟低、准确度高
2. 盘后数据覆盖:区别于 Yahoo Finance 等免费接口,原生支持盘后交易数据
3. 缓存机制:令牌缓存 20 小时,减少重复鉴权开销,提升查询效率
4. 轻量依赖:仅需 Python3 环境,无复杂库依赖,部署简单
潜在缺点与局限性
- 付费门槛:需 Quodd 订阅账号(QUODD_USERNAME/PASSWORD),免费用户无法使用
- 地域限制:仅限 US equities(美国股票),不支持港股、A股等其他市场
- 功能单一:仅提供报价数据(高/低/收盘价/盘后),无 K 线历史、财务指标、新闻等深度数据
- CLI 形态:无 GUI 或 Web 界面,纯命令行工具,非技术用户上手门槛较高
适合人群
- 量化开发者:需要程序化获取实时报价构建交易策略
- 专业投资者:已有 Quodd 数据订阅,需要轻量 CLI 工具快速查价
- 金融分析师:盘后数据研究者,关注 AH(After Hours)价格变动
常规风险
- 凭证安全:环境变量明文存储用户名密码,多用户共享服务器存在泄露风险
- 令牌缓存:
~/.openclaw/credentials/quodd-token.json文件权限若配置不当,可能被本地其他用户读取 - API 依赖:服务可用性完全依赖 Quodd 官方,无备用数据源,API 变更或订阅到期将导致功能失效
- 合规注意:实时行情数据受交易所版权保护,需确保使用符合 Quodd 许可协议及当地金融监管要求