基础取数有免费额度；全市场池与大规模批量需 Starter 及以上。详见[定价页](https://alphafeed.org/)。

AlphaFeed Python SDK 怎么安装和鉴权？（5 分钟拿到第一条 A 股数据）

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

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

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

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

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

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

Q: 报 PermissionError 怎么办？

说明该能力需要更高套餐（如全市场 `universes`）。可先用单标的接口，或参考[定价页](https://alphafeed.org/)升级。

入门与取数 · 代码验证于 2026-09-28

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 的三种来源与优先级：

方式	写法	说明
环境变量（推荐）	`export ALPHAFEED_API_KEY=...` → `AlphaFeed()`	不进源码、最安全
`.env` 文件	`python-dotenv` 加载后 `AlphaFeed()`	本地开发方便，`.env` 要加 `.gitignore`
显式传参	`AlphaFeed(api_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 / 401	没配 `ALPHAFEED_API_KEY` 或 Key 错误	检查环境变量是否生效、Key 是否复制完整
`PermissionError`/权限不足	用了需更高套餐的能力（如 `universes` 全市场池）	换单标的接口，或升级套餐
429 / 限频	请求过快	SDK 内置重试会退避；业务侧降低频率（见限频一文）
连接超时	网络问题	重试；检查代理/网络

关键坑与注意事项

绝不硬编码 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 股数据请求。