AKShare 接口、数据源与统计口径
保留品类、命名、注册表、来源与返回值的历史盘点。
调查基线为原材料记载的 2026-10-04、AKShare v1.19.1、浅克隆短提交号 fac1e50。本轮读取了归档报告；未取得原运行环境或重跑接口、全库计数及 npm 检索。下文统计和“实测”均属于原调查记录，不能自动代表当前版本或服务可用性。短提交链接本轮未成功取得，数字保留为历史证据并披露复算边界。
二、提供的接口内容（品类、数量、数据源）
接口总数：1096 个（多口径对账）
| 统计口径 | 数值 | 说明 |
|---|---|---|
ast 解析 __init__.py 导入名 | 1101 → 去重 1096 | 344 条 import，5 个重名覆盖（stock_margin_*_bse 等） |
运行时 dir(akshare) 可调用公开属性 | 1102 | = 1096 接口 + 6 异常类，与 __all__ 一致 |
官方注册表 akshare/data/interfaces.json | 1090 | 差集恰为 6 个非数据接口（get_token/set_token/pro_api/interface_info/list_categories/search），1090+6=1096 完全对账 |
| 模块级公开函数（含未导出） | 1181 | 其中 85 个内部工具/品种表函数从未被 __init__.py 导出；1181−85=1096，两口径不矛盾 |
注册表分类分布：stock 388 / macro 215 / index 94 / fund 90 / futures 83 等。documented 是 interfaces.json 的逐接口布尔字段，含义为"该接口能否在 docs/data 数据字典中匹配到文档条目"，由构建脚本生成（scripts/build_registry.py:232 "documented": doc is not None；:285 undocumented = 导出名 − 已文档名）——即 1090 条中 1015 条有官方数据字典文档、75 条未文档化（原调研修订实读 interfaces.json 复核为 1015）。
品类分布（合计 1096）
| 品类 | 接口数 | 源文件 | 代表接口 |
|---|---|---|---|
| 股票（stock+stock_feature+stock_fundamental） | 395 | 146 | stock_zh_a_hist、stock_zh_a_spot_em、stock_board_industry_name_em |
| 宏观经济（economic，中/美/欧/日/德/英/澳/加/瑞士/香港） | 225 | 17 | macro_china_gdp_yearly、macro_usa_gdp_monthly（macro_china.py 单文件 77 个） |
| 指数（index） | 95 | 25 | index_zh_a_hist、drewry_wci_index、index_option_50etf_qvix |
| 基金（fund+qdii+reits） | 94 | 28 | fund_open_fund_daily_em、fund_etf_hist_em |
| 期货（futures+futures_derivative） | 83 | 36 | futures_main_sina、futures_zh_daily_sina |
| 期权（option） | 46 | 17 | option_cffex_hs300_daily_sina、option_current_em |
| 债券（bond） | 46 | 15 | bond_zh_cov、bond_cb_index_jsl |
| 另类数据（other/movie/air/event/nlp/energy/article） | 46 | 17 | movie_boxoffice_daily、air_city_table、migration_area_baidu |
| 现货（spot） | 15 | 3 | spot_golden_benchmark_sge、spot_hist_sge |
| 外汇（forex+fx+currency） | 15 | 8 | currency_boc_safe、fx_quote_baidu |
| 新闻与榜单（news+fortune） | 11 | 7 | news_cctv、news_economic_baidu、forbes_rank |
| 工具与元接口（cal/tool/hf/pro/registry/utils/qhkc_web） | 19 | 9 | tool_trade_date_hist_sina、search、interface_info |
| 利率与银行（rate/interest_rate/bank） | 4 | 3 | repo_rate_hist、rate_interbank |
| 加密货币（crypto） | 2 | — | crypto_js_spot |
注：index_vix 在 1.19.1 中不存在（复核纠正），实际存在的是 optbbs.com 的 QVIX 系列（index_option_50etf_qvix 等 18 个，akshare/index/index_option_qvix.py）。
三套"股票"数字的口径调和（395 / 407 / 388 并非前后矛盾，统计维度不同）：
- 395（接口品类 表）：按源码子包归组——stock(130) + stock_feature(208) + stock_fundamental(57) 三子包的导出函数；
- 407（命名口径）：按函数名前缀
stock_统计； - 388（接口数量口径 注册表）：按 interfaces.json 的 category 字段——构建脚本依 docs/data 文档目录归类，不完全等同源码子包。
三套差集原调研修订已实测对账：前缀口径比子包口径多 13 个以 stock_ 命名但定义在其他子包的接口（如 stock_hk_index_daily_em、stock_zh_index_daily_em 属 index 子包、stock_news_em 属 news 子包），少 1 个不以 stock 开头的 get_us_stock_name（在 stock_fundamental 子包）；注册表口径则把 11 个同花顺系接口（stock_board_*_ths、stock_financial_*_ths）归入其他品类、又把 4 个 news_*_baidu/stock_news_em 归入 stock（395 − 11 + 4 = 388，逐一对上）。
命名规律
「前缀_主体_后缀」三段式：
- 前缀 = 资产/主题：stock 407、macro 226、index 79、fund 74、futures 66、option 46、bond 44、spot 16；
- 主体 = 市场+品种+内容：市场词 zh_a/zh_us/hk，频率词 daily/monthly/yearly，内容词 spot/hist/hold/margin/rank；
- 后缀 = 数据源标识：
_em(东财)254、_sina60、_ths(同花顺)43、_cninfo(巨潮)30、_xq(雪球)14、_lg12、_baidu12、_sse11、_sw11、_szse10、_czce9、_soozhu8……合计 474/1096≈43.2% 的接口以数据源后缀结尾；同一数据常有多源版本可互为备份（如 bond_cb_index_jsl 与 bond_zh_cov）。
数据源全景
原调查的 URL 域名计数合并 HTTP 与 HTTPS 口径；这些是字面出现次数，不代表请求量或独立接口数。
| 域名 | 原记录次数 |
|---|---|
data.eastmoney.com | 338 |
datacenter-web.eastmoney.com | 175 |
vip.stock.finance.sina.com.cn | 131 |
datacenter.jin10.com | 127 |
quote.eastmoney.com | 123 |
webapi.cninfo.com.cn | 122 |
data.10jqka.com.cn | 100 |
finance.sina.com.cn | 89 |
legulegu.com | 66 |
chinamoney.com.cn | 50 |
www.szse.cn / www.czce.com.cn | 各 42 |
www.sse.com.cn / www.gfex.com.cn | 36 / 34 |
- 东方财富是第一大源（30+ 子域 + dfcfw.com + eastmoneyfutures.com，合计 123 个源文件引用）；
- 新浪财经 44 个文件、巨潮 19、同花顺 17、乐咕 13、金十 12、百度系 8、腾讯行情 6、雪球 4、集思录 3、英为财情 3（复核纠正了原 53/10 的高估）；
- 交易所/官方机构：sse(14)/szse(11)/shfe(11)/czce(11)/dce(9)/gfex(8)/cffex(7)/ine(3)/bse(3)、中国货币网、中债、中证指数、国证指数、申万研究、国家统计局、商务部、外管局、金监总局、上金所、基金业协会、交易商协会等；
- 海外学术/机构：圣路易斯联储 FRED、达特茅斯 Tuck、芝加哥大学 Booth、耶鲁、牛津 Oxford-Man 已实现波动率库、Baker EPU、Drewry 运价、CNBS 国家资产负债表等；
- 另类：票房、空气质量、人口迁徙、义乌小商品指数、柯桥时尚指数、乘联会汽车销量、碳排放、猪价等。
- 注意：世界银行/OECD/IMF 在本版本源码中零命中（grep worldbank/oecd/imf.org 均无结果）——海外宏观数据经东财/金十/新浪等渠道获取。
返回值约定与文档
- 统一返回
pandas.DataFrame（列名多为中文）。运行时实测 8 个品类 8 个接口全部返回 DataFrame：原调研点名 6 个——fund_open_fund_daily_em（基金）、macro_china_gdp_yearly（宏观）、news_cctv（新闻）、futures_main_sina（期货）、crypto_js_spot（加密）、tool_trade_date_hist_sina（工具）；原调研修订补测 2 个品类成功——currency_boc_safe（外汇，→ DataFrame(8059,26)）、spot_hist_sge（现货，→ DataFrame(2375,5)）。另 2 个东财接口（stock_zh_a_spot_em/forex_spot_em）因调研沙箱被远端断连未能实测，失败原因与接口当前可用性未确定。少数例外：nlp_answer返回 str（akshare/nlp/nlp_interface.py:43）、interface_info返回 Dict（akshare/registry.py:215）、set_token/get_token/pro_api 为工具型。 - 文档规模：docs/ 下 47 个 md + 4 个 rst（3.0MB），数据字典 docs/data/ 按 21 个品类子目录组织，28 个 md 共 69905 行（stock.md 单文件 25523 行、macro.md 12129 行）。
最后更新于