AKShare 金融数据获取
任务目标
- 本 Skill 用于：通过 AKShare 接口获取全品类金融市场数据
- 能力包含：股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济等数据
- 触发条件：用户提及 AKShare 或需要获取各类金融数据时
前置准备
- 依赖说明：安装 akshare 库（已包含在 dependency 中）
- 凭证配置：AKShare 无需注册或 API Key，直接调用即可使用
- 环境要求：Python 3.9+，建议定期更新
pip install akshare --upgrade
操作步骤
- 标准流程：
- 确定数据需求 — 智能体理解用户意图（股票/期货/基金/外汇等）
- 调用对应脚本 — 根据数据类型选择脚本
- 解析结果 — 智能体分析返回的 JSON 格式数据
- 脚本调用映射：
- 股票数据 →
python scripts/stock_data.py --type hist --symbol 000001 --start 20240101 --end 20240131 - 期货数据 →
python scripts/futures_data.py --type daily --exchange CFFEX --start 20240101 --end 20240131 - 基金数据 →
python scripts/fund_data.py --type etf --symbol 510300 - 外汇数据 →
python scripts/forex_data.py --type spot --symbol usd - 宏观经济 →
python scripts/macro_data.py --type gdp - 加密货币 →
python scripts/crypto_data.py --type price --symbol BTC/USDT
- 股票数据 →
- 可选分支：
- 当需要多只标的：使用逗号分隔多个代码
- 当需要指定周期：使用
--period参数（daily/weekly/monthly） - 当需要复权数据：使用
--adjust参数（qfq/hfq/空值）
使用示例
- 示例1：获取股票历史K线
- 场景/输入：用户说"获取贵州茅台2024年的日K线数据"
- 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等OHLCV数据
- 关键要点：调用
python scripts/stock_data.py --type hist --symbol 600519 --start 20240101 --end 20241231 --period daily --adjust qfq
- 示例2：获取期货数据
- 场景/输入：用户说"查看沪深300股指期货数据"
- 预期产出：返回期货合约的K线数据、持仓量、成交量等信息
- 关键要点：调用
python scripts/futures_data.py --type daily --symbol IF2406 --start 20240101 --end 20240131
- 示例3：获取基金数据
- 场景/输入：用户说"查询沪深300ETF的行情"
- 预期产出：返回ETF的实时行情或历史净值数据
- 关键要点：调用
python scripts/fund_data.py --type etf --symbol 510300
- 示例4：获取宏观经济数据
- 场景/输入：用户说"查看中国GDP数据"
- 预期产出：返回GDP历史数据和最新值
- 关键要点：调用
python scripts/macro_data.py --type gdp
数据分类详解
完整的 API 函数清单（70+ 个接口，覆盖股票/期货/基金/期权/债券/外汇/指数/加密货币/宏观经济/特色数据）见 references/api-catalog.md。
快速索引：
- 股票 →
ak.stock_zh_a_hist(),ak.stock_zh_a_spot_em() - 期货 →
ak.futures_zh_spot(),ak.get_futures_daily() - 基金 →
ak.fund_etf_spot_em(),ak.fund_etf_hist_em() - 宏观 →
ak.macro_china_gdp(),ak.macro_usa_cpi_monthly() - 特色 →
ak.stock_lhb_detail_em()（龙虎榜）,ak.stock_hsgt_hist_em()（北向资金）
资源索引
脚本：
- scripts/stock_data.py（用途与参数：获取股票K线/行情/财务数据，支持 --type/--symbol/--start/--end/--period/--adjust）
- scripts/futures_data.py（用途与参数：获取期货数据，支持 --type/--symbol/--exchange/--start/--end）
- scripts/fund_data.py（用途与参数：获取基金数据，支持 --type/--symbol/--start/--end）
- scripts/forex_data.py（用途与参数：获取外汇贵金属数据，支持 --type/--symbol）
- scripts/macro_data.py（用途与参数：获取宏观经济数据，支持 --type）
- scripts/crypto_data.py（用途与参数：获取加密货币数据，支持 --type/--symbol/--period）
- scripts/index_data.py（用途与参数：获取指数数据，支持 --type/--symbol/--start/--end）
- scripts/option_data.py（用途与参数：获取期权数据，支持 --type/--symbol）
- scripts/bond_data.py（用途与参数：获取债券数据，支持 --type/--symbol）
- scripts/special_data.py（用途与参数：获取龙虎榜/融资融券/北向资金等特色数据，支持 --type/--symbol/--start/--end）
参考文档：
- API 函数速查表（何时读取：需要查看完整 AKShare API 函数清单时）
- 股票数据文档（何时读取：需要查看股票相关API参数说明时）
- 期货数据文档（何时读取：需要查看期货相关API参数说明时）
- 基金数据文档（何时读取：需要查看基金相关API参数说明时）
- 宏观经济文档（何时读取：需要查看宏观数据API参数说明时）
- AKShare官方文档（何时读取：需要查看最新API文档时）
注意事项
- AKShare 无需注册或 API Key，直接调用即可使用
- A股股票代码格式：纯数字代码（如 000001、600519），不带市场前缀
- 港股股票代码格式：纯数字代码（如 00700）
- 美股股票代码格式：英文代码（如 AAPL、TSLA）
- 数据列名：A股数据为中文列名，美股/港股数据为英文列名
- 建议定期更新AKShare版本：
pip install akshare --upgrade - 由于上游数据源变化，接口更新频繁，遇到错误时可先尝试更新版本
- 脚本返回 JSON 格式数据，智能体负责解析并转换为用户友好的展示
- 非Python用户可使用 AKTools HTTP API封装
- 数据仅供学术研究使用，不构成投资建议
快速参考
函数命名规则
{asset_type}_{market}_{data_type}_{data_source}
- Asset type:
stock（股票）,futures（期货）,fund（基金）,bond（债券）,forex（外汇）,option（期权）,macro（宏观）,index（指数） - Market:
zh（中国）,us（美国）,hk（香港）, 或交易所代码 - Data type:
spot（实时）,hist（历史）,daily（日线）,minute（分钟） - Data source:
em（东方财富）,sina（新浪财经）, 交易所缩写
复权类型
""- 不复权"qfq"- 前复权"hfq"- 后复权
周期类型
"daily"- 日线"weekly"- 周线"monthly"- 月线"1","5","15","30","60"- 分钟线
