AlphaFeed Python SDK 怎么安装和鉴权？

一句话回答： 三步即可跑起来：① pip install alphafeed 安装 SDK；② 把 API Key 放进环境变量 ALPHAFEED_API_KEY（或调用时传 AlphaFeed(api_key=...)）；③ af.klines.get("600519.SH") 取第一条数据。AlphaFeed 的 AlphaFeed() 默认自动读取环境变量里的 Key，无需硬编码。

为什么会有这个问题 / 传统做法的痛点

新手最常卡在「装好了但连不上」：要么没设 API Key、要么把密钥硬编码进源码提交上去（危险），要么分不清「鉴权失败」和「权限不足」两类报错。下面给出从安装到第一条数据的最小可运行路径，并把 Key 的安全管理和常见报错一次讲清。

分步骤解决（每步配可运行代码）

第 1 步：安装 SDK

pip install alphafeed
# 或用 uv：uv add alphafeed
# 需要 DataFrame 输出时确保有 pandas：pip install pandas

import alphafeed
print(alphafeed.__version__)   # 确认安装成功，如 0.1.4

第 2 步：配置 API Key（推荐环境变量，别硬编码）

# Linux/macOS：写入环境变量（建议放进 ~/.bashrc 或项目 .env）
export ALPHAFEED_API_KEY="af_你的key"

from alphafeed import AlphaFeed

af = AlphaFeed()                       # 默认自动读取 ALPHAFEED_API_KEY
# 或显式传入（不推荐写死在源码里）：
# af = AlphaFeed(api_key="af_你的key")

Key 的三种来源与优先级：

第 3 步：第一条请求（取 K 线）

df = af.klines.get("600519.SH", period="1d", count=5,
                   adjust="forward", to_dataframe=True)
print(df[["trade_date", "open", "close"]].to_string(index=False))

拿到 DataFrame 就说明安装 + 鉴权都通了。再试试实时快照与基础信息：

q = af.quotes.get(symbols=["600519.SH"], to_dataframe=True)   # 实时快照
i = af.instruments.get("600519.SH")                            # 基础信息
print(q[["symbol", "last_price"]].to_dict("records"), i["name"])

第 4 步：鉴权/权限报错怎么排查

try:
    df = af.klines.get("600519.SH", count=5, to_dataframe=True)
except Exception as e:
    print(type(e).__name__, str(e)[:120])

常见报错对照：

关键坑与注意事项

• 绝不硬编码 Key 到源码：用环境变量或 .env（且 .env 加入 .gitignore），避免密钥泄露到 Git。
• AlphaFeed() 默认读环境变量：设好 ALPHAFEED_API_KEY 后直接 AlphaFeed() 即可，无需传参。
• 鉴权失败 ≠ 权限不足：前者是 Key 问题（401/未设置），后者是套餐问题（PermissionError），排查方向不同。
• to_dataframe=True 需要 pandas：没装 pandas 会报缺依赖，按需 pip install pandas。
• 免费额度有限：调试时配合本地缓存减少重复请求（见缓存一文），避免快速耗尽额度。
• 多环境隔离：开发/生产用不同 Key 与 .env，别混用。

常见问题（FAQ）

Q：包名是什么？怎么装？

A：pip install alphafeed（或 uv add alphafeed）。导入用 from alphafeed import AlphaFeed。

Q：一定要设环境变量吗？能直接传 Key 吗？

A：可以 AlphaFeed(api_key="...")，但不推荐把 Key 写死在源码。生产用环境变量最安全。

Q：怎么确认鉴权成功了？

A：能成功返回一条 af.klines.get(...) 数据即说明安装与鉴权都通了。

Q：报 PermissionError 怎么办？

A：说明该能力需要更高套餐（如全市场 universes）。可先用单标的接口，或参考定价页升级。

Q：需要付费吗？

A：基础取数有免费额度；全市场池与大规模批量需 Starter 及以上。详见定价页。

小结

上手 AlphaFeed 只需三步：pip install alphafeed → 设 ALPHAFEED_API_KEY 环境变量 → af.klines.get(...) 取第一条数据。记住「Key 别硬编码、鉴权失败查 Key、权限不足查套餐」，几分钟就能从零跑通第一个 A 股数据请求。

参考

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