核心用法
Quodd 是一个通过 Quodd API 获取美股实时行情数据的 CLI 工具。用户可通过 Python 脚本查询单个或多个股票代码的当前价格、日内高低点及盘后交易数据。支持文本和 JSON 两种输出格式,便于直接阅读或程序化处理。
显著优点
1. 实时数据覆盖:提供日高/日低、收盘价及盘后交易时间和价格,数据维度完整
2. 多 ticker 批量查询:支持一次查询多只股票,提升效率
3. 认证 token 缓存机制:自动缓存登录凭证 20 小时,减少频繁认证开销
4. 灵活输出格式:默认表格形式直观,JSON 模式便于集成到自动化工作流
潜在缺点与局限性
- 依赖外部商业 API:需单独申请 Quodd 账号(QUODD_USERNAME/PASSWORD),非免费服务
- 地域限制明确:仅覆盖 US equities 美股市场,不支持 A股/港股等其他市场
- 环境变量强依赖:未提供交互式登录,配置门槛对非技术用户较高
- 缓存刷新需手动干预:凭证变更后需显式使用
--no-cache,否则可能遭遇认证失败
适合人群
- 需要程序化获取美股实时行情的投资者或量化开发者
- 已有 Quodd API 订阅权限的机构/个人用户
- 熟悉命令行操作和 Python 环境的技术用户
常规风险
- 凭证泄露风险:API 密码以环境变量形式存储,需确保
~/.bashrc或部署环境的安全 - 盘后数据时效性:盘后价格可能延迟或波动较大,不宜作为实时交易决策唯一依据
- API 服务可用性:依赖 Quodd 第三方服务,存在接口变更或服务中断风险
- 缓存凭证安全:token 存储在本地
~/.openclaw/credentials/,需关注目录权限设置