akshare / First Run

akshare 首次运行：第一个接口调用与最小示例

安装后，import akshare as ak 即可开始。以下是最小示例：调用一个股票接口、一个宏观接口，确认能拿到 pandas DataFrame。

股票示例宏观示例

入口：import akshare as ak返回：pandas DataFrame注意：接口名随版本变化

import akshare导入 akshare as ak

调用接口ak.stock_zh_a_hist(...)

DataFrame直接用于分析

akshare 首次运行最小示例示意图（示例性，非运行截图）。

Stock

股票数据最小示例

获取 A 股实时行情与历史 K 线（接口名以 akshare 1.18+ 为准）。

示例代码（示例性）import akshare as ak

# A股实时行情
df_spot = ak.stock_zh_a_spot_em()

# 单只股票历史日线（前复权）
df_hist = ak.stock_zh_a_hist(symbol="000001", period="daily", adjust="qfq")

说明：以上接口名来自 EasyClaw akshare-finance 技能「直接使用 akshare API」章节；stock_zh_a_hist 是 akshare 1.18+ 的接口（旧版为 stock_zh_kline）。实际调用以当前版本官方文档为准。

Macro

宏观数据最小示例

获取 GDP、CPI、PMI、货币供应等宏观指标。

示例代码（示例性）df_gdp = ak.macro_china_gdp()
df_cpi = ak.macro_china_cpi()
df_pmi = ak.macro_china_pmi()
df_m2  = ak.macro_china_money_supply()  # 旧版 macro_china_m2

版本提示：macro_china_m2 已更名为 macro_china_money_supply。旧教程中的接口名可能已失效。

Crypto

加密货币行情示例

获取主流交易所加密行情。

示例代码（示例性）df_crypto = ak.crypto_js_spot()  # 主流交易所行情

拿到数据后做什么

akshare 只负责「取数」。拿到 DataFrame 后，清洗、分析、回测是下一步。

数据清洗

处理缺失值、类型转换、时间序列对齐，为后续分析做准备。

分析与回测

结合 pandas/numpy 计算指标、做策略回测（结果仅供研究）。

对接量化 Skill

不想写代码时，可看 EasyClaw 量化研究类 Skill 作为替代路线。

查看实战教程查看数据接口清单

FAQ

常见问题

为什么接口名报 AttributeError？

接口名随 akshare 版本变化（1.18+ 更名较多）。请对照当前版本官方文档，或运行 dir(ak) 查看可用接口。

返回的 DataFrame 为空怎么办？

可能是上游数据源限流、接口参数不对或网络问题。确认参数正确后稍后重试；数据仅限学术研究。

不写代码能拿到这些数据吗？

可以。EasyClaw 的 akshare-finance 技能封装了 akshare，可一句话发起取数/宏观/加密行情任务，免自行写 Python。

实时数据准确吗？

数据来自公开财经网站，实时数据可能有延迟；仅供学术研究，不构成投资建议，建议多数据源交叉验证。

能直接下单交易吗？

不能。akshare 是数据接口库，不提供交易执行；交易需另接券商/交易系统。