美股/港股字段差异：K 线 amount=0 怎么处理

一句话回答： 不是 bug。用 AlphaFeed 取历史 K 线（klines）时，A 股的 amount（成交额）是真实值，美股/港股的 amount 为 0.0——这是数据源口径差异，美港股历史 K 线只给量不给额，用 volume 替代即可。注意一个反差：实时快照 quotes 的 amount 对美股/港股是有值的（实测 AAPL.US ≈ 234 亿、00700.HK ≈ 85 亿）。所以「amount=0」只发生在美港股的历史 K 线，不发生在实时 quotes。跨市场代码要对 amount 字段按市场分别处理。

为什么会有这个问题

AlphaFeed 用统一的 {代码}.{市场} 一套接口取 A/US/HK（见 multi-market-a-us-hk），字段名也统一。但底层数据源对不同市场提供的字段完整度不同：

• A 股历史 K 线：volume（手）+ amount（元）都有；
• 美股/港股历史 K 线：只有 volume（股），amount 恒为 0.0。

如果你的跨市场代码直接用 amount 算 VWAP、换手额、成交额排名，在美港股上就会得到 0——不是数据缺失报错，而是字段口径差异，需要显式处理。

实测：三市场字段对比

from alphafeed import AlphaFeed
af = AlphaFeed(api_key="your-api-key")  # 或 export ALPHAFEED_API_KEY 后 AlphaFeed()

for s in ["600519.SH", "AAPL.US", "00700.HK"]:
    k = af.klines.get(s, period="1d", count=5, to_dataframe=True)
    print(s, "amount前3:", k["amount"].head(3).tolist(), "| volume末:", k["volume"].iloc[-1])

实测结果：

关键反差：美港股历史 K 线 amount=0，但实时 quotes 的 amount 有值。别把两者混为一谈。

跨市场字段差异对照

统一处理方案

def safe_amount(df, market: str):
    """历史 K 线成交额：美港股用 close×volume 估算替代 0。"""
    if market == "SH" or market == "SZ" or market == "BJ":
        return df["amount"]                      # A 股直接用真实成交额
    # 美港股 volume 单位是股，用 收盘价×成交量 估算成交额
    return df["close"] * df["volume"]

# 或：需要精确实时成交额时，用 quotes 而非 klines
q = af.quotes.get(symbols="AAPL.US")[0]
realtime_amount = q["amount"]                     # 美股实时 amount 有值

关键坑与注意事项

• amount=0 只在美港股历史 K 线：实时 quotes 的 amount 美港股有值，别误以为整个美港股都没有成交额。
• volume 单位跨市场不同：A 股是「手」（1 手=100 股），美港股是「股」。跨市场算换手、金额时务必换算，否则差 100 倍。
• 美港股成交额用 close×volume 只是估算：历史 K 线没有真实 amount，用收盘价乘量是近似（日内均价≠收盘价），要精确成交额用实时 quotes 或改用别的口径。
• 别在美港股用 amount 排序/算 VWAP：会全是 0。先判市场再决定用 amount 还是 volume。
• 交易日历与时区各市场不同：跨市场对齐日期要分别处理（美东/港/沪深），不能直接按行号对齐。

常见问题（FAQ）

Q：美股 K 线 amount=0 是数据缺失或报错吗？

A：不是。是数据源对美港股历史 K 线不提供成交额的口径差异，接口正常返回、只是该字段为 0。用 volume 或实时 quotes.amount 替代。

Q：那我要美股历史成交额怎么办？

A：历史 K 线没有真实 amount，可用 close×volume 估算；要精确值用实时 quotes（美港股 quotes 的 amount 有值），或接受「美港股以量为准」。

Q：A 股和美股的 volume 能直接比吗？

A：不能。A 股 volume 单位是「手」，美港股是「股」，差 100 倍，比之前先统一单位。

Q：需要付费吗？

A：多市场历史与实时有免费额度可体验，大批量/全市场实时建议 Starter 及以上，详见官网定价页。

小结

跨市场取数时，「美港股 K 线 amount=0」是字段口径差异而非 bug：历史成交额仅 A 股可靠，美港股用 volume（注意单位是「股」不是「手」）或实时 quotes.amount。写跨市场代码先判市场再选字段，就不会被 0 和单位坑到。

参考

• AlphaFeed Python SDK 文档：https://docs.alphafeed.org/zh-Hans/sdk/python-quickstart