数据源与延迟
数据源、覆盖范围与延迟说明
交易员最关心数据是不是自动刷新、从哪里来、延迟多久、失败时怎么处理。这里按来源逐项说明。
可核验披露接口
这部分来自后端 `/api/disclosures`，用于状态页、首页和外部检查统一核验。
接口状态
可用
披露版本
0.2.0
数据源 / 市场
6 个 / 5 个
待补齐
3 项
统一警示
仅用于投研辅助，正式交易前请以券商或交易所授权行情为准。
更新时间：2026/6/13 19:31:25
下一步披露动作
继续把 /api/disclosures 的数据源、延迟和边界摘要嵌入首页、状态页和个股页。给每个行情卡片增加 source / latency / updated_at。继续接入授权行情或明确免费源延迟边界。
当前数据源清单
当前版本优先做投研辅助，不代表交易所直连授权行情。
| 来源 | 覆盖 | 延迟/限制 | 用途 | 注意 |
|---|---|---|---|---|
Yahoo Finance chart endpoint active | 美股、ETF、ADR、部分港股、日股、韩股和欧洲股票的公开图表数据。 | 公开源，可能延迟、缓存、限流；盘前盘后和小众市场可能缺失。 | 全球终端线盘、悬浮窗走势、报价回退。 | 不是交易所直连授权行情；正式下单前必须以券商或交易所授权行情为准。 |
Stooq quote endpoint active | 美股、ETF、部分全球股票的公开快照报价。 | 通常为延迟或快照数据；部分交易所无覆盖。 | 全球行情、榜单市值/报价回退、跨市场样本。 | 不能替代 Level 1/Level 2 授权行情，也不保证盘中秒级连续更新。 |
Nasdaq / EDGAR Online IPO feed active | 美国 IPO 计划、定价、撤回和近 30 天上市样本。 | 来源页面可能延迟或临时返回空；会展示来源健康状态。 | 新股模块、IPO 日历和新股播报。 | IPO 状态必须结合交易所、SEC 文件和券商资料复核。 |
StockAnalysis IPO calendar active | 美国 IPO 计划上市、已定价待交易和近期 IPO 补充数据。 | 公开网页源，可能受页面结构、缓存和限流影响。 | 补齐 Nasdaq 源没有覆盖的新股状态。 | 若多个来源冲突，页面必须标注来源和状态，不把空结果解释为没有新股。 |
OpenAI structured analysis degraded_until_key_configured | 新闻结构化、影响股票提取、事实新闻摘要和播报文本生成。 | 受模型请求、网络、限流和 API key 配置影响。 | 新闻交易化、双语播报、AI 观点卡和风险解释。 | AI 输出必须标注不构成投资建议；需要事实源、失败样本和复盘验证。 |
Manual user input / screenshot import active | 用户手动持仓、截图 OCR 交易导入、自选和风险线。 | 取决于用户输入或截图识别时间。 | 账户模式、持仓风险、止损线、组合风险面板。 | OCR 和手动输入可能出错；真实账户资产以券商系统为准。 |
数据分级与交易适用性
刷新快不等于交易所直连授权行情。这里把每一层能做什么、不能做什么写清楚。
| 级别 | 来源 | 延迟/状态 | 交易适用性 | 失败显示规则 |
|---|---|---|---|---|
| 交易所授权行情源 | Polygon、券商 API、交易所授权数据 | 取决于授权套餐和交易所协议 | 正式交易前必须接入这一层，尤其是盘前盘后、Level-2、期权链和逐笔成交。 | 没有授权时必须明确显示“未接交易所授权源”，不能用免费源冒充交易所直连授权行情。 |
| 公开行情源 | Yahoo Finance、Stooq 等公开接口 | 可能延迟、缓存、限流或返回 404 | 适合投研、观察和图表预览，不适合高频或真钱执行。 | 失败时显示暂无、失败原因、最近成功时间，不补假数据。 |
| 公开新闻/新股源 | 公开新闻源、Nasdaq IPO Calendar、StockAnalysis、Renaissance、SEC EDGAR Online | 取决于来源发布时间、抓取速度和模型处理速度 | 用于事件发现、结构化摘要和待核验线索。 | 显示来源、发布时间、抓取时间和 AI 结构化状态。 |
| AI 结构化层 | OpenAI 模型对新闻、公告、榜单和产业链文本做摘要与分类 | 默认按用户设置刷新；接口失败时保留旧结果并显示失败原因 | 只做解释和提醒，不能替代原文、公告和价格验证。 | AI 输出必须带来源、理由、风险和失效条件；缺字段时应降级展示。 |
| 用户输入层 | 手动持仓、截图导入、风险线、自选和提醒偏好 | 取决于用户输入和 OCR 校验 | 用于个人风险面板、止损提醒和复盘。 | 保存前必须允许用户确认；识别不确定时标记“需复核”。 |
市场覆盖与交易时段说明
支持市场不是一句口号；每个市场都必须标明交易时段、货币、延迟和当前边界。
| 市场 | 主要交易所/样本 | 货币 | 常规交易时段 | 盘前盘后 | 延迟口径 | 风险边界 |
|---|---|---|---|---|---|---|
| 美股 | Nasdaq、NYSE、AMEX、ARCA、OTC 样本。 | USD | 常规 09:30-16:00 ET；盘前盘后视数据源覆盖。 | 公开源可能缺失盘前盘后完整成交。 | 公开行情源，可能延迟或缓存；交易所直连授权行情未接入。 | ETF、ADR、期权链、借券费率和 Level 2 需要独立授权数据源。 |
| 港股 | HKEX 样本，支持 0700.HK 等后缀规范化。 | HKD | 港股常规交易含午休；节假日需按港交所日历。 | 暂不承诺完整盘前竞价和收市竞价细节。 | 公开行情源，可能延迟或缺失。 | 窝轮、牛熊证和港股通额度暂不作为交易级数据展示。 |
| 日股 | Tokyo Stock Exchange 样本，支持 7203.T 等后缀。 | JPY | 东京交易时段和午休需要按交易所日历展示。 | 暂不承诺夜盘或 PTS 覆盖。 | 公开行情源，可能延迟、缓存或缺样本。 | 需额外处理日元汇率、日银事件和出口股敏感度。 |
| 韩股 | KOSPI / KOSDAQ 样本，支持 005930.KS 等后缀。 | KRW | 韩国交易时段、休市和外资流向需单独标注。 | 暂不承诺盘后竞价完整覆盖。 | 公开行情源，可能延迟、缓存或缺样本。 | 三星、SK Hynix 权重和韩元汇率会放大跨市场风险。 |
| A 股 | 上交所、深交所样本，支持 600519.SS / 300750.SZ。 | CNY | A 股常规交易含午休；涨跌停制度必须单独提示。 | 不适用美股式盘前盘后。 | 公开行情源，可能延迟或缺少完整市场深度。 | 北向资金、融资融券和盘口深度需要授权或专门数据源。 |
延迟和失败显示规则
后续所有行情、榜单、新闻和悬浮窗都应按这些规则显示。
- 页面数据为自动刷新数据，不代表交易所直连授权行情；刷新频率不等于行情授权等级。实际延迟取决于数据源、市场状态和刷新频率。
- 盘前、盘后、Level-2、逐笔成交、期权链、借券费率等仍需要正式券商或交易所授权数据源。
- 任何市场数据失败时，页面应显示失败、延迟、缓存或暂无，而不是伪装为交易所直连授权行情。
- 跨市场涉及时区、货币、假期和交易规则差异，价格、涨跌幅和市值需要按来源口径核验。
未接入前不能宣传的专业数据
这些数据必须接正式授权源，不能用免费源或 AI 猜测替代。
- Level-2 盘口深度、逐笔成交和完整订单簿尚未接入正式授权源。
- 期权链、隐含波动率、Greeks、借券费率和做空可借数量尚未作为正式模块上线。
- 券商真实下单、撤单、改单和自动交易 Agent 关闭；账户连接第一阶段只做只读或手动录入。
- 跨市场汇率、公司行动、停复牌、假期和交易制度仍需要补齐权威源。
- AI 历史命中率、盈亏比、最大回撤和纸面模拟账户仍需持续记录后公开展示。
页面刷新频率不是行情授权
自动刷新不代表交易所直连授权行情。
播报与新闻
默认约 10 分钟刷新；用户可在偏好里调整，但仍受数据源、模型和网络限制。
悬浮窗与全球终端
前端会高频轮询当前股票，但数据源本身可能是延迟或缓存。
状态页
每 15 秒查询 `/api/status`，用于判断服务和数据新鲜度，不代表行情速度。