免费股票异动榜 API
构建可信的涨幅榜、跌幅榜与活跃榜，必须明确交易时段、比较基准价、排序公式、流动性门槛、证券范围、时间戳和行情权限，而不能只接受服务商返回的前 20 名。
摘要
涨幅榜可能按百分比或绝对涨跌额排序，“活跃”也可能指成交股数、成交金额、交易笔数或异常放量，必须保存真实排序字段。
盘前、常规交易、盘后和完整交易日使用的流动性与基准价不同，应明确标注时段和时区。
价格下限、成交量或成交金额门槛、证券类型、交易所、停牌状态和公司行动都会显著改变排名。
免费 key 可能只能获得延迟、历史或收盘数据；每条结果都应返回服务商时间戳与时效状态。
选择免费股票行情 API 时要检查什么
可用的市场异动榜 API 应清楚回答实际问题：提供哪些涨跌或成交活跃榜单、免费套餐返回什么、行情延迟多久，以及结果能否直接用于扫描器、看板、提醒或 AI Agent。
异动榜本质上是派生数据。排名取决于可选证券范围、快照时间、比较前收盘价、公司行动复权、陈旧报价处理和并列规则。即使使用相同原始行情，两家 API 也可能返回不同榜单；生产级数据契约必须提供足够元数据解释差异。
涨幅榜与跌幅榜覆盖
确认接口是否同时返回两个方向，以及按涨跌幅、价格变动还是其他字段排序。
成交活跃榜的定义
核对“活跃”代表成交股数、成交金额、成交笔数，还是供应商自定义逻辑。
实时行情权限
免费 API Key 不代表免费实时行情；交易所授权、15 分钟延迟和收盘数据可能分别处理。
市场与交易时段
检查美股交易所、盘前盘后、最低成交量过滤、分页、时间戳与每日重置时间。
基准价与公司行动
确认涨跌幅使用的是上一常规交易时段收盘价、复权收盘价、当前时段开盘价还是其他基准。拆股和特别分派若未一致复权，会制造虚假的异动股票。
证券范围与质量过滤
核对普通股、ETF、ADR、认股权证、单位、OTC、停牌证券和陈旧报价的处理方式，以及价格下限与最低成交金额。未经筛选的宽泛范围往往会把低流动性噪声推到榜首。
实算示例：同一快照可以产生四份合理榜单
假设下面是常规交易时段快照，前收盘均已完成复权，且只包含符合条件的普通股。涨跌幅按 (当前价 ÷ 前收盘 − 1) × 100 计算，成交金额按 当前价 × 成交股数 计算。
| 股票 | 前收盘 / 当前价 | 涨跌幅 | 成交股数 | 成交金额 |
|---|---|---|---|---|
| A | $10 / $12 | +20% | 100,000 | $1.2M |
| B | $50 / $51 | +2% | 2,000,000 | $102M |
| C | $5 / $4 | −20% | 5,000,000 | $20M |
榜首取决于明确写出的指标。A 是涨幅榜第一，C 同时是跌幅榜和成交股数榜第一，B 则按成交金额排名第一。若把四种结果都叫作“最活跃”，或使用未说明的字段对混合榜单排序，结果就无法复现。每份榜单都应保存公式、筛选条件、快照时间和并列处理规则。
免费美股涨跌榜 API 对比
| 供应商 | 榜单覆盖 | 免费层注意点 | 适合场景 |
|---|---|---|---|
| Alpha Vantage | 美股涨幅、跌幅与最活跃股票各 20 个。 | 文档说明默认返回历史数据；延迟或实时数据取决于 entitlement。 | 快速制作三榜原型。 |
| Massive | 美股涨幅或跌幅前 20 名及快照字段。 | 需在当前套餐与文档中核对端点权限和行情授权。 | 基于快照的扫描器。 |
| Webull | 支持盘前、盘后、日内及更长周期的涨跌榜。 | 需要 OpenAPI 接入和行情权限，不能假设所有层级都免费或免鉴权。 | 按交易时段排名。 |
| QVeris | 发现并调用合适的金融数据能力，不虚构独立交易所行情源。 | 返回数据仍受所选供应商额度、许可与时效约束。 | 需要可检查工具调用的 Agent。 |
如何接入股票异动榜 API
明确需要涨幅榜、跌幅榜、活跃榜还是盘前异动，并记录市场、时区、排序字段和最低流动性规则。
核对请求配额、端点权限、鉴权方式、署名、商业使用条款，以及免费响应是否延迟。
映射为股票代码、价格、涨跌额、涨跌幅、成交量、时间戳和交易时段，并保留供应商原始时间。
榜单快照可能每日清空后重建；应显式处理休市、开盘前、限流、空列表和过期时间戳。
当最新价、基准价和成交量齐全时，应重新计算涨跌额与涨跌幅，再应用自身流动性过滤并检查排序。陈旧报价、无效基准价、拆股跳变和与文档排序字段不一致的名次都应标记。
缓存键应包含市场、交易时段、证券范围、过滤条件、排序字段、行情权限与快照时间。不能把盘前榜当作常规交易榜，也不能在服务商时间戳过期后继续标注“实时”。
用 QVeris 发现并调用股票异动数据
QVeris 可以帮助 Agent 发现并检查涨幅榜、跌幅榜、成交股数榜、成交金额榜或特定时段异动榜能力。调用前，应明确市场、证券类型、交易时段、排序公式、流动性门槛、返回数量、行情权限与可接受时效；结果必须注明服务商时间戳，也不能比较基于不同证券范围或时段生成的排名。
- 打开 涨幅榜、跌幅榜与活跃股票工具详情，核对榜单范围和交易时段。
- 调用供应商能力前，先检查参数与返回字段。
- 在应用中保留供应商许可、免费额度与时间戳信息。
常见问题
部分服务商提供免费 key 或有限套餐。应核对包含哪些榜单、结果是当前还是历史数据、交易所行情权限、请求额度、证券范围、署名与商业使用条款。
有可能，但不能根据免费 key 推断。应检查交易所权限、服务商时间戳、刷新频率、交易时段和延迟标签；端点频繁刷新，也可能只是反复返回延迟行情。
通常按相对明确基准价的涨跌幅排序，绝对涨跌额作为另一字段。还要定义交易时段、复权基准、证券范围、价格和流动性门槛、陈旧报价规则与并列处理。
它可能按成交股数、成交金额、交易笔数、换手率或相对历史的异常放量排序。接口必须说明指标和窗口，这些榜单不能互相替代。
选择明确支持延长交易时段的端点，指定盘前 session，核对比较基准与快照时间，并采用更严格的流动性过滤，因为盘前交易通常更稀疏。
差异可能来自证券范围、行情权限、快照时间、交易时段、基准价、公司行动复权、过滤条件或排序字段。比较这些数据契约后，才能判断榜单是否有误。