/akshare

AKShare 开源金融数据接口库，提供股票、期货、期权、基金、外汇、债券、指数、加密货币等全品类金融数据；当用户需要获取各类金融市场数据时使用

BOOST

lzwme@lzwme

GitHub

From plugin

finance-quant-skills

44113 skills

Install

$ npx -y skills add lzwme/finance-quant-skills --skill akshare --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/akshare

Context preview

The summary Claude sees to decide when to auto-load this skill.

AKShare 开源金融数据接口库，提供股票、期货、期权、基金、外汇、债券、指数、加密货币等全品类金融数据；当用户需要获取各类金融市场数据时使用

SKILL.md

akshare.SKILL.md

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

AKShare 金融数据获取

任务目标

本 Skill 用于：通过 AKShare 接口获取全品类金融市场数据
能力包含：股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济等数据
触发条件：用户提及 AKShare 或需要获取各类金融数据时

前置准备

依赖说明：安装 akshare 库（已包含在 dependency 中）
凭证配置：AKShare 无需注册或 API Key，直接调用即可使用
环境要求：Python 3.9+，建议定期更新 `pip install akshare --upgrade`

操作步骤

标准流程：

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](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](scripts/stock_data.py)（用途与参数：获取股票K线/行情/财务数据，支持 --type/--symbol/--start/--end/--period/--adjust）
[scripts/futures_data.py](scripts/futures_data.py)（用途与参数：获取期货数据，支持 --type/--symbol/--exchange/--start/--end）
[scripts/fund_data.py](scripts/fund_data.py)（用途与参数：获取基金数据，支持 --type/--symbol/--start/--end）
[scripts/forex_data.py](scripts/forex_data.py)（用途与参数：获取外汇贵金属数据，支持 --type/--symbol）
[scripts/macro_data.py](scripts/macro_data.py)（用途与参数：获取宏观经济数据，支持 --type）
[scripts/crypto_data.py](scripts/crypto_data.py)（用途与参数：获取加密货币数据，支持 --type/--symbol/--period）
[scripts/index_data.py](scripts/index_data.py)（用途与参数：获取指数数据，支持 --type/--symbol/--start/--end）
[scripts/option_data.py](scripts/option_data.py)（用途与参数：获取期权数据，支持 --type/--symbol）
[scripts/bond_data.py](scripts/bond_data.py)（用途与参数：获取债券数据，支持 --type/--symbol）
[scripts/special_data.py](scripts/special_data.py)（用途与参数：获取龙虎榜/融资融券/北向资金等特色数据，支持 --type/--symbol/--start/--end）

参考文档：

[API 函数速查表](references/api-catalog.md)（何时读取：需要查看完整 AKShare API 函数清单时）
[股票数据文档](references/stock.md)（何时读取：需要查看股票相关API参数说明时）
[期货数据文档](references/futures.md)（何时读取：需要查看期货相关API参数说明时）
[基金数据文档](references/fund.md)（何时读取：需要查看基金相关API参数说明时）
[宏观经济文档](references/macro.md)（何时读取：需要查看宏观数据API参数说明时）
[AKShare官方文档](https://akshare.akfamily.xyz)（何时读取：需要查看最新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`（新浪财经）, 交易所缩写