Free Top Losers API
Stock Movers & Python免费股票跌幅榜 API
数据源、字段与 Python

What a free top losers API should accomplish免费股票跌幅榜 API 应完成哪些任务

This page targets downside-risk monitoring. A useful losers feed helps a risk desk or agent distinguish a genuine drawdown from a bad print, reverse split, stale prior close, temporary halt, or illiquid microcap. The result should be joined to negative catalysts, portfolio exposure, short-sale constraints, and halt status before it triggers escalation. It is not simply the gainers page with the sort direction reversed.

本页聚焦下行风险监控。可用的跌幅榜数据应帮助风险团队或 Agent 区分真实回撤、错误成交、反向拆股、陈旧前收盘、临时停牌和低流动性微盘股。触发升级前，还应关联负面催化因素、组合敞口、卖空限制和停复牌状态。它绝不是把涨幅榜排序方向反过来那么简单。

The default leaderboard should state whether it ranks last trade, midpoint, bid, or an official session close against an adjusted prior close. That choice matters most during fast selloffs: the last trade may precede a halt, the bid can reprice before another trade occurs, and an after-hours print may be far outside the regular-session market. Risk systems should therefore keep the raw market ranking separate from their own exposure-weighted escalation queue.

默认榜单必须说明：它使用最新成交、中间价、买价还是官方时段收盘价，并以哪一种复权前收盘为基准。快速下跌时，这个选择尤其重要：最新成交可能发生在停牌之前，买价可能在下一笔成交前已经重估，盘后成交也可能远离常规盘市场。因此，风险系统应把原始市场排名与按自身敞口加权的升级队列分开。

What a stock market top losers API should return股票跌幅榜 API 应返回哪些字段

Free stock market losers API sources to evaluate可评估的免费股票涨跌幅榜接口

Treat the provider table as a verification checklist, not an endorsement; availability and terms can change. Evaluate every candidate with the same fixed incident set: an ordinary decline, earnings gap, reverse split, distribution ex-date, intraday halt, resumed auction, delisting event, and thin after-hours trade. Record which rows each source includes, how it timestamps them, and whether the displayed loss can be rebuilt from underlying prices.

下表只是一份供应商核验清单，不代表背书；接口权限和条款可能变化。评估时应让每个候选来源使用同一组固定事件，包括普通下跌、财报跳空、反向拆股、分派除权日、盘中停牌、复牌竞价、退市事件和稀疏盘后成交，并记录各数据源纳入哪些证券、如何标记时间，以及能否用底层价格重算所示跌幅。

Top losers API Python example and validation股票跌幅榜 API Python 示例与验证

Build an executable-market list from normalized rows and route excluded anomalies to review. This example requires an active, valid quote; recalculates the decline from an adjusted prior close; and refuses to turn a missing or terminal price into zero.

应从归一化记录构建具有当前可交易意义的榜单，并把被排除的异常记录转入复核。下面的示例要求报价有效且仍在交易，以复权前收盘重新计算跌幅，同时拒绝把缺失价格或终止报价状态补成零。

from decimal import Decimal, InvalidOperation


def build_tradable_losers(
    rows: list[dict],
    minimum_dollar_volume: Decimal = Decimal("1000000"),
    limit: int = 20,
) -> tuple[list[dict], list[dict]]:
    eligible, review = [], []
    for row in rows:
        reasons = []
        if row.get("session") != "regular":
            reasons.append("outside_regular_session")
        if row.get("halt_status") != "trading":
            reasons.append("halted_or_terminal")
        if row.get("quote_status") != "valid":
            reasons.append("stale_or_invalid_quote")
        if row.get("prior_close_adjusted") is not True:
            reasons.append("unverified_baseline")
        if row.get("corporate_action_status") not in {None, "resolved"}:
            reasons.append("unresolved_corporate_action")
        try:
            current = Decimal(str(row["current_price"]))
            prior_close = Decimal(str(row["prior_regular_close"]))
            bid = Decimal(str(row["bid"]))
            ask = Decimal(str(row["ask"]))
            volume = Decimal(str(row["volume"]))
        except (KeyError, InvalidOperation):
            review.append({"symbol": row.get("symbol"), "reasons": ["invalid_numeric_fields"]})
            continue
        if min(current, prior_close, bid, ask) <= 0 or volume < 0:
            reasons.append("non_positive_price_or_volume")
        if bid > ask:
            reasons.append("crossed_market")
        change_pct = ((current / prior_close) - Decimal("1")) * Decimal("100") if prior_close > 0 else Decimal("0")
        if change_pct <= Decimal("-100") or change_pct >= 0:
            reasons.append("not_a_valid_decline")
        if current * volume < minimum_dollar_volume:
            reasons.append("insufficient_dollar_volume")
        if reasons:
            review.append({"symbol": row.get("symbol"), "reasons": reasons})
            continue
        eligible.append({
            "symbol": row["symbol"], "exchange": row["exchange"],
            "current_price": current, "prior_regular_close": prior_close,
            "change_pct": change_pct, "bid": bid, "ask": ask,
            "source_timestamp": row["source_timestamp"],
            "rule_version": "tradable-losers-v1",
        })
    eligible.sort(key=lambda item: (item["change_pct"], item["symbol"]))
    for rank, item in enumerate(eligible[:limit], start=1):
        item["rank"] = rank
    return eligible[:limit], review

How QVeris helps connect market movers APIsQVeris 如何连接股票涨跌幅榜能力

• Open the QVeris tool details for stock screener, quote, corporate-action, filing, and market-status capabilities.
• Inspect inputs, outputs, authentication, supported markets, provider documentation, quote conditions, timestamps, and adjustment conventions before connecting.
• Make session, baseline, eligible universe, freshness tolerance, portfolio context, and escalation schema explicit in the tool request.
• Use the QVeris Capability Map to explore adjacent data tools; connectivity and downside rankings are not investment advice.

• 使用 QVeris 工具详情搜索选股器、报价、公司行动、申报与市场状态能力。
• 连接前检查输入、输出、鉴权、支持市场、供应商文档、报价条件、时间戳与复权规则。
• 在工具请求中明确写出交易时段、比较基准、证券池、时效容忍度、组合背景和升级输出结构。
• 通过 QVeris 能力地图探索相邻数据工具；连接能力和下跌排名不构成投资建议。

Free top losers API FAQ免费股票跌幅榜 API 常见问题

Authoritative references权威与原始参考链接