免费实时股票 API：数据、行情源与限制

先确认实时行情的时间与来源

如何验证股票数据是否真正实时

仅有“实时”标签远远不够。应根据交易所时间戳测量新鲜度，识别底层数据源，并确认许可允许的使用方式。

实时股票价格只是数据流中的一个字段

实时股票价格 API 可能只返回最近一笔符合条件的成交。更广泛的股票数据流还可以提供买卖报价、成交数量与条件、OHLCV 聚合、市场状态、停牌、证券元数据和更正信息。这些记录回答的问题不同：自选列表可能只需要最新价和交易状态，价差监控需要买卖报价，执行模型需要事件级成交与报价，图表通常需要周期 K 线。比较供应商前必须先定义记录类型，否则可能为速度付费，却拿到错误的数据。

“实时”背后的数据覆盖与时钟

低延迟并不保证市场覆盖完整。对于美国股票，供应商可能分发来自证券信息处理机构的综合信息、特定交易所数据、FINRA 设施、OTC 来源，或券商自己的市场视图。单一场所的数据可以很快送达，却仍与全市场不同，因为交易分布在多个场所。必须记录数据流或交易场所，除非文档明确支持，否则不要把单一来源称为“整个市场”。

时间戳可以标准化为统一内部格式，但必须保留原始值和精度。单纯转换时区无法修复“把 K 线结束时间当作成交时间”这种语义错误。接入测试时，应对高流动性和低流动性标的在常规、盘前、盘后、停牌和休市状态下分别测量事件年龄。如果没有新的有效事件，价格不变并不自动表示数据陈旧。

实时股票数据的“免费”究竟意味着什么

比较已核验边界，而不是宣传标签

Alpha Vantage 目前说明，大多数免费数据集每天最多调用 25 次，而美国市场实时和 15 分钟延迟数据属于付费能力。Financial Modeling Prep 的文档请求要求 API Key，并列出了报价、历史、公司、日历和市场数据端点；具体端点权限与延迟取决于当前套餐。Massive（原 Polygon.io）记录了来自交易所、证券信息处理机构、FINRA 设施和 OTC 市场的美国股票成交、报价、聚合行情、快照与参考记录，数据流访问同样由套餐和授权控制。套餐可能调整，因此实施时必须重新核验。

构建能经受生产环境的 WebSocket 实时流

WebSocket 连接只是传输通道。可靠的消费者还必须完成认证、订阅、确认订阅状态、处理心跳、保留序列号或事件标识、检测缺口、采用有上限的退避重连，并在不创建重复处理器的情况下恢复订阅。当消息到达速度超过下游存储或界面处理能力时，系统还必须保护自己。

不要把高频 REST 轮询伪装成实时流

每秒轮询一次报价端点可能耗尽免费配额，让多个用户的请求形成同步流量峰值，同时仍会遗漏所有中间成交。应合并相同请求，让多个用户共享一次上游刷新，为定时轮询加入随机抖动，并根据供应商更新频率和产品承诺选择节奏。如果持续事件覆盖确实是硬性要求，应选择具有相应权限的流式数据，而不是试图用快照拼出实时流。

如何可靠集成实时股票数据

接收标准化事件前先检查数据时效

下面这个与供应商无关的 Python 函数把数据时效变成可测量指标。它接收已经解析的事件时间，与 UTC 客户端接收时间比较，拒绝超出允许时钟误差的未来事件，并标记超过产品最大允许时效的数值。阈值应来自产品要求和市场状态，而不是套餐名称中的“实时”二字。

from datetime import datetime, timezone

def validate_freshness(event_time, max_age_seconds, clock_skew_seconds=2):
    received_at = datetime.now(timezone.utc)
    event_time = event_time.astimezone(timezone.utc)
    age = (received_at - event_time).total_seconds()

    if age < -clock_skew_seconds:
        raise ValueError("Event timestamp is unexpectedly in the future")

    return {
        "event_time": event_time.isoformat(),
        "received_at": received_at.isoformat(),
        "age_seconds": max(age, 0),
        "is_stale": age > max_age_seconds,
    }

应在字段结构和标的身份验证后运行该函数，并把结果与原始响应一起保存。它不能证明供应商时间戳语义一定正确，也不能证明数据流覆盖完整；这些仍需要阅读文档和进行跨来源测试。休市或停牌期间，应根据市场状态选择合适阈值与提示，而不是持续产生错误的陈旧数据告警。

常见问题