AKShare 金融数据获取技能用于通过 AKShare 接口获取全品类金融市场数据,适用于用户提及 AKShare 或需要获取各类金融数据时。
一、用途 该技能面向金融数据获取场景,可拉取股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济等数据。触发条件为用户提及 AKShare,或需要获取各类金融数据。
二、主要能力 覆盖的资产类别包括:股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济及特色数据。技能内提供完整的 API 函数清单(70+ 个接口),并给出快速索引,例如:股票对应 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()(北向资金)。
三、使用方式 前置准备:安装 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/空值)。
脚本资源包括: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 官方文档,可按需读取。
四、使用示例 示例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。
五、适用场景 适用于需要获取各类金融市场数据的场景,包括股票行情与历史K线、期货合约数据、基金行情与净值、外汇贵金属数据、宏观经济指标、加密货币价格、指数数据、期权与债券数据,以及龙虎榜、融资融券、北向资金等特色数据。
六、限制与注意事项 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 表示分钟线。