免费实时 股票报价 API
构建前比较延迟、时间戳、交易所覆盖、REST 与 WebSocket、
请求频率限制和使用许可。
核心摘要
免费股票报价 API 通常足以支撑演示、个人仪表盘、课程作业和低流量研究工具。
“实时”并非统一标准。务必核对交易所、报价时间、交易时段以及是否延迟。
最新成交价、中间价、买一价、卖一价和前收盘价并不相同，应为每个产品界面明确选择口径。
缓存重复请求，在允许时批量查询，并保留供应商适配层，方便日后切换。
实时股票报价应包含哪些字段
只有代码和一个数字远远不够。可靠应用还需要足够的上下文来解释价格，避免混用不同口径的数据。
| 数据 | 应包含字段 | 用途 | 常见误区 |
|---|---|---|---|
| 最新报价 | 价格、时间戳、币种、交易所、交易时段 | 自选股与价格快照 | 把延迟数据当作实时数据 |
| 买一价与卖一价 | 买价、卖价、挂单量、报价时间 | 价差与流动性展示 | 把陈旧报价误认为最新成交 |
| 交易时段信息 | 市场状态、前收盘价、涨跌额、涨跌幅 | 正确计算日内涨跌 | 混用常规与盘前盘后时段 |
| 证券元数据 | 标准代码、名称、类型、市场、状态 | 搜索与校验 | 不同交易所代码冲突 |
不要把报价压缩成一个价格
买价、卖价、两侧挂单量、报价时间、最新成交、成交时间、前收盘价和交易时段应分别保存。中间价是衍生值，最近成交也可能已经陈旧。如果接口只返回一个名为 price 的字段，必须通过文档确认它究竟代表成交价、某侧报价、官方收盘价还是供应商标记价。
确认报价属于综合行情还是单一场所
一份报价可以对某个交易场所实时，却不代表整个市场。应保留交易所或数据源标识，不能把单一场所的买价、卖价或成交量标为综合数据。盘前盘后数据必须明确记录交易时段，计算涨跌时也要使用与口径匹配的前收盘价。
“免费”与“实时”究竟意味着什么
把标称额度换算成自己的负载：股票数 × 刷新次数 × 用户数。每日额度看似充足，也可能被严格的每分钟调用上限限制。
免费数据可能延迟、仅提供日终价格，或不完整覆盖盘前盘后。界面应明确显示时间戳和延迟，避免暗示实时行情质量。
核对最大证券数量、URL 长度、每只证券的额度消耗、返回顺序、部分失败、重复代码，以及一个错误代码是否会让整批请求失败。
测试主要上市、不同股票类别、ETF、ADR、OTC 和失效代码。内部主键应包含市场与稳定 ID，不能只使用 ticker。
向单个账户展示报价、服务器缓存、计算信号、供团队访问或公开再分发，可能分别需要不同权限。
如何可靠集成实时股票报价
把供应商响应映射为自己的 Quote、Bar 和 Instrument 模型。保留原始响应用于排错，但不要让供应商字段名散布到产品代码。
日线历史数据的缓存时间应远长于活跃报价。用明确的数据时效规则合并重复请求，保护免费额度。
过滤异常时间戳、负价格、币种不一致、重复 K 线和意外时区变化，并记录数据供应商与采集时间。
同一时刻收到的批量响应中，不同证券可能拥有不同的最后更新时间。应按每个源时间戳计算年龄，并单独保留接收时间。
为每只证券返回状态，仅重试临时错误，并保留最后有效报价及其年龄。不能用零替代不可用价格，也不能把残缺自选列表标为当前数据。
跨用户合并相同请求，错峰刷新大型自选列表，遵守突发和每日额度，并且不要以高于数据源或产品更新速度的频率轮询。
验证盘前开盘、常规开盘、停牌、常规收盘和盘后行为，确保涨跌额与涨跌幅使用预期参考时段重新计算。
使用 QVeris 查找实时报价能力
本页未核实到精确匹配的 QVeris 实时股票报价工具及对应 Provider 页面。接入前应通过 QVeris 文档与 QVeris Playground 探测准确字段与行情源语义。
- 明确要求买价、卖价、挂单量、成交、源时间戳、币种、交易所或数据源、交易时段和批量支持。
- 如果通用价格结果不说明价格类型或延迟，应直接排除。
- 保存发现请求、已检查能力、参数、原始响应、抓取时间和校验结论。
常见问题
有时可以，但交易所、授权、市场覆盖和延迟各不相同。不要只看“实时”标签，应核对时间戳和许可。
部分 API 支持批量股票代码，另一些每次只能查询一个。既要核对单次批量上限，也要确认每只股票如何计入免费额度。
不是。它是某个时点已完成的交易。当前报价需要买价、卖价、挂单量和报价时间戳。
应返回逐证券错误，并保留最后有效值及其年龄。不能静默丢弃该证券，也不能用零替代。
参考资料与下一步
Alpha Vantage 报价文档
Finnhub 报价 API
Twelve Data 文档
Alpaca 市场数据