Quodd

📈 实时美股行情,官方数据直连

Quodd 官方 API 实时美股行情获取工具,支持盘后数据与多 ticker 批量查询,需订阅凭证使用。

收藏
10.5k
安装
2.5k
版本
0.1.0
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心用法

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 许可协议及当地金融监管要求

安全解读

核心功能

Quodd Stock Quotes 是一款专注于美股实时行情查询的轻量级工具,通过调用 Quodd 官方 API 获取当前价格、日高日低及盘后交易数据。用户可通过命令行快速查询单只或多只股票,支持文本与 JSON 两种输出格式,满足日常投资跟踪与程序化数据处理的双重需求。

显著优点

  • 零依赖设计:仅使用 Python 标准库,无第三方包引入,极大降低供应链攻击风险
  • 安全凭证管理:QUODD_USERNAME/PASSWORD 通过环境变量读取,拒绝硬编码
  • 智能 Token 缓存:认证令牌本地缓存 20 小时,减少重复登录开销,支持 --no-cache 强制刷新
  • 灵活输出:默认表格视图直观易读,--format json 便于集成至自动化工作流
  • 多股并发:单命令支持多只 ticker 批量查询,提升操作效率

潜在局限

  • 数据源单一:完全依赖 Quodd API 可用性,若服务中断或限流将直接影响功能
  • 地域限制:仅覆盖 US equities,不支持港股、A股等其他市场
  • 功能边界:纯报价工具,无历史数据、技术指标或图表功能
  • 环境配置门槛:需提前注册 Quodd 账户并导出环境变量,对新手不够友好

适合人群

  • 美股投资者与交易员,需快速获取实时报价
  • 金融数据分析师,构建轻量级自动化监控脚本
  • 开发者/量化爱好者,寻求低依赖的行情数据接口

常规风险

1. Token 缓存权限:缓存文件位于 ~/.openclaw/credentials/,若系统权限配置宽松可能被同用户组读取
2. 凭证传输:用户名密码通过 HTTPS Header 发送,符合 API 规范但依赖强密码策略

3. API 服务稳定性:个人/社区维护级别,无 SLA 保障,生产环境建议增加熔断与降级逻辑

4. 输入验证:当前仅做基础大小写处理,异常 ticker 可能导致 API 返回错误而非本地拦截

Quodd 内容

scripts文件夹
手动下载zip · 4.6 kB
quote.pytext/plain
请选择文件