akshare - SKILL.md Agent Skill

name: akshare description: AKShare 开源金融数据接口库，提供股票、期货、期权、基金、外汇、债券、指数、加密货币等全品类金融数据；当用户需要获取各类金融市场数据时使用 metadata: {"openclaw":{"emoji":"📈","requires":{"bins":["python3"]}}} keywords: - 股票 - 期货 - 期权 - 基金 - 外汇 - 债券 - 指数 - 加密货币 - 宏观经济 - AKShare

标准流程：
1. 确定数据需求 — 智能体理解用户意图（股票/期货/基金/外汇等）
2. 调用对应脚本 — 根据数据类型选择脚本
3. 解析结果 — 智能体分析返回的 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。

快速索引：

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）

{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（新浪财经）, 交易所缩写