Stock Prices

核心用法

Stock Prices API 是一个轻量级美股实时行情接口，通过简单的 HTTP GET 请求即可获取指定股票的多维度市场数据。基础调用格式为 https://stock-prices.on99.app/quotes?symbols={SYMBOLS}，支持单次最多50只标的批量查询，符号间用逗号分隔。

返回数据结构：JSON 格式包含 symbol（代码）、currentPrice（现价）、change（涨跌额）、percentChange（涨跌幅百分比）、highPrice/lowPrice（日内高低点）、openPrice（开盘价）、previousClosePrice（昨收）、以及完整的盘前数据字段（preMarketPrice、preMarketChange 等）。所有价格单位为美元，时间戳采用 ISO 8601 UTC 标准。

典型应用场景：个人投资组合监控、自动化交易策略的信号输入、盘前盘后异动追踪、以及简单的市场 sentiment 分析（如统计涨跌家数、计算平均涨跌幅等）。

显著优点

1. 极简接入：无需 API Key、无认证门槛，curl 或任意 HTTP 客户端即可调用，适合快速原型开发
2. 实时数据覆盖：不仅提供常规交易时段行情，还包含盘前（pre-market）完整数据，对追踪财报后或重大消息后的价格反应尤为关键
3. 批量查询效率：单请求支持50只标的，降低高频监控场景下的网络开销
4. 数据字段完整：从基础价量到百分比变动、从开盘价到昨收对比，满足大多数非专业级分析需求

潜在缺点与局限性

1. 来源可信度不明：域名 on99.app 非知名金融数据供应商（非 Bloomberg、非 Alpha Vantage、非 Yahoo Finance 官方），数据来源与更新链路未公开说明，存在数据质量与持续可用性风险
2. 无历史数据：仅提供实时快照，不支持 K 线、分钟线或日终历史序列，无法直接用于回测或技术分析
3. 无交易量数据：响应字段中缺失成交量（volume），这是判断价格变动有效性的关键指标
4. 地域与市场局限：文档示例全为美股（AAPL、NVDA 等），未提及其他市场（A股、港股、加密货币等）支持情况
5. 无 SLA 保障：免费服务通常伴随速率限制、突发故障或数据延迟，不适用于生产级交易决策

适合人群

• 个人投资者/散户：快速查看持仓盈亏、盘前异动
• 开发者初学者：学习 API 调用、JSON 解析的实践项目
• 轻量级自动化脚本：如 Discord/Telegram 股价机器人、个人看板数据源的低成本方案

常规风险

• 数据准确性风险：非官方数据源可能存在报价延迟、字段计算错误（如 percentChange 精度问题）
• 服务中断风险：个人/小众托管服务可能因成本、合规或流量问题突然下线
• 合规边界：若用于向第三方提供服务，需注意金融数据再分发的版权与合规要求
• 无责任声明：文档未提及数据免责声明，实际使用建议交叉验证关键价格

核心用法

stock-prices 是一个纯文档型 Skill，无内置可执行代码，仅提供调用 stock-prices.on99.app 外部 API 的完整说明。用户通过 HTTP GET 请求 /quotes?symbols={SYMBOLS} 端点，可获取单只或多只美股（最多 50 只）的实时报价、涨跌幅、日高日低、开盘价、昨收及盘前交易数据。返回 JSON 结构清晰，包含 currentPrice、change、percentChange、preMarketPrice 等字段，便于直接用于价格监控、盈亏计算或市场摘要生成。

文档中提供了丰富的 TypeScript/JavaScript 示例，涵盖价格检查、组合追踪、市场涨跌统计等场景，并附带 FAANG+ 等热门股票代码速查表，降低入门门槛。

显著优点

• 零依赖接入：无需安装任何 SDK 或依赖库，直接通过 curl 或标准 fetch 即可调用，集成成本极低。
• 数据维度全面：除常规实时价格外，额外提供盘前（Pre-Market）价格与涨跌幅，满足盘后策略分析需求。
• 批量查询友好：单次请求最多支持 50 个标的，适合构建投资组合看板。
• 隐私合规优秀：无敏感数据收集，不触碰用户身份或交易隐私，符合 GDPR/CCPA 要求。
• 安全扫描高分：静态、动态、依赖审计均通过，无可执行代码风险。

潜在缺点与局限性

• 数据来源不明：on99.app 域名非主流金融数据服务商，数据准确性、延迟、覆盖市场范围（是否含港股、A 股等）均未在文档中说明。
• 无 SLA 保障：个人开发者维护（T3 来源），服务稳定性、API 限流策略、长期可用性存疑，不适合生产级量化交易依赖。
• 功能单一：仅支持查询最新报价，无历史 K 线、财务指标、技术指标等进阶数据，无法满足深度分析需求。
• 缺乏认证机制：文档未提及 API Key 或 OAuth，若未来接口增加鉴权，现有代码可能失效。

适合人群

• 个人投资者或爱好者，需要快速搭建股价监控脚本或 Telegram/Discord 机器人。
• 金融数据分析学习者，希望用真实数据练习 JavaScript/TypeScript 数据处理。
• 轻量级产品原型开发，对数据实时性要求不高、可容忍偶尔中断的场景。

常规风险

1. 数据可靠性风险：小众 API 可能出现价格延迟、错误甚至服务终止，建议与 Yahoo Finance、Alpha Vantage 等主流数据源交叉验证。
2. 网络超时与限流：未文档化的限流策略可能导致高频请求被封禁，需自行实现指数退避重试。
3. 合规边界：虽然 Skill 本身不收集隐私，但用户若将查询结果与真实持仓关联存储，需自行承担数据安全责任。