AlphaFeed 查不到代码返回空?非法/缺后缀 symbol 的行为与处理

一句话回答: 传错代码时 AlphaFeed 不抛异常,而是返回空结果 (quotes.get 返回空 list )。实测:600519.SH 正常返回 1 条;而 999999.SH(查无)、BADCODE(乱填)、600519(缺 .SH/.SZ 后缀 )都返回空 list、len==0 。危险点就在「静默空值」------不校验就 [0] 会直接 IndexError,或让空数据悄悄混进流程。正确做法:先规范化代码(补后缀/大写),再判空。诚实边界:本文描述的是当前 SDK 行为,以你实测为准;历史 K 线对无效代码也可能返回空 DataFrame,同样要判空。

这个行为为什么要特别讲

很多人默认「查错会报错」,于是写 af.quotes.get(symbols=s)[0]。但 AlphaFeed 对无效代码是返回空、不报错:

  • [0] 直接 IndexError: list index out of range;
  • 批量里混入无效代码,结果数量对不上、又没异常提示,容易静默出错。

最常见的触发是缺后缀 :600519 ❌、必须 600519.SH ✅。

实测行为

python 复制代码
from alphafeed import AlphaFeed
af = AlphaFeed(api_key="your-api-key")  # 或 export ALPHAFEED_API_KEY 后 AlphaFeed()

for s in ["600519.SH", "999999.SH", "BADCODE", "600519"]:
    r = af.quotes.get(symbols=s)
    print(repr(s), "len=", len(r))
# '600519.SH' len= 1
# '999999.SH' len= 0   ← 查无此代码:空
# 'BADCODE'   len= 0   ← 乱填:空
# '600519'    len= 0   ← 缺后缀:空(最常见的坑)
输入 结果 原因
600519.SH 1 条 合法
999999.SH 空 list 查无此代码
BADCODE 空 list 非法格式
600519(缺后缀) 空 list 必须带 .SH/.SZ/.BJ

正确写法:规范化 + 判空

python 复制代码
def normalize(sym: str) -> str:
    sym = sym.strip().upper()
    if "." not in sym:                 # 补后缀:6/9 开头→.SH,0/3→.SZ,8/4→.BJ(简化规则)
        if sym[:1] in ("6", "9"): sym += ".SH"
        elif sym[:1] in ("0", "3"): sym += ".SZ"
        elif sym[:1] in ("8", "4"): sym += ".BJ"
    return sym

def safe_last_price(sym: str):
    rows = af.quotes.get(symbols=normalize(sym))
    if not rows:                        # 先判空,别直接 [0]
        return None                     # 或 raise 你自己的业务异常
    return rows[0]["last_price"]

print(safe_last_price("600519"))        # 经规范化→600519.SH→正常取到
print(safe_last_price("999999"))        # None(查无)

批量时按 symbol 对齐并记录缺失:

python 复制代码
want = ["600519.SH", "999999.SH", "000001.SZ"]
got = {q["symbol"]: q for q in af.quotes.get(symbols=want)}
missing = [s for s in want if s not in got]   # 找出返回里缺的(无效/查无)

关键坑与注意事项

  • 缺后缀是头号原因 :A 股必须带 .SH/.SZ/.BJ;代码格式见 stock-symbol-code-format-suffix。
  • 先判空再取下标 :if not rows: ...,别 rows[0] 裸取,否则 IndexError。
  • 批量按 symbol 对齐:返回数量可能少于请求(无效项被丢),用字典对齐并记录 missing,别按下标假设。
  • K 线无效代码返回空 DataFrame :klines.get 对无效代码可能返回空表,同样 if df.empty: 判。
  • 退市/停牌≠无效:退市代码可能查无(空),停牌股历史仍在;区分「代码无效」与「暂时无数据」。
  • 大小写/空格 :规范化时 strip().upper(),避免 600519.sh、带空格取不到。

常见问题(FAQ)

Q:为什么查错不报错,而是返回空? A:这是当前 SDK 的设计(容忍无效输入、返回空)。好处是不中断批量,代价是你必须自己判空,否则静默出错。

Q:最常见的「取不到」原因是什么? A:缺后缀。600519 取不到,必须 600519.SH。先规范化再查。

Q:批量里有无效代码会整个失败吗? A:不会,无效项只是不在返回里。用字典按 symbol 对齐、算出 missing 列表即可。

Q:需要付费吗? A:查询有免费额度可体验,详见官网定价页。

小结

AlphaFeed 对非法/缺后缀/查无代码是返回空、不抛异常 :最常见的坑是缺 .SH/.SZ 后缀。写法上先规范化代码、再判空 (if not rows),批量按 symbol 对齐并记录 missing,就能避免 IndexError 和静默空值。本文行为已真实验证。

参考

相关推荐
isfox14 分钟前
Python 单元测试:别再用 print 调试了,写个测试一劳永逸
python
用户2986985301435 分钟前
在 Python 中把 Word 文档转换为 JSON 的三种实现方式
python·json·api
用户0332126663671 小时前
使用 Python 删除 Excel 中的空白行或空白列
python·excel
databook1 小时前
时间序列特征,哪些当时就能算出来
python·数据分析
kevin_org1 小时前
LangChain入门学习(四)
python·学习·langchain·fastapi
特立独行的猫A10 小时前
别再用 nohup 了:让应用在后台常驻的正确姿势与 systemd 服务详解
java·后端·python
吃我一窝jio13 小时前
Python与Go线程模型深度对比
java·开发语言·python
zwd200513 小时前
Manim 怎么放大画面的某一部分?
python·动画·可视化·manim·数学动画
屿华AI14 小时前
AUTOSAR 实战-诊断工具 | UDS 0x27 安全访问的配置化实现:种子密钥算法插件化设计
python·测试工具·汽车