# Akshare Finance

> 中国 A股/期货/基金/债券/宏观数据查询工具。基于 AKShare Python 库，无需 API Key，装完即用。触发场景：用户询问"查一下股票"、"茅台股价"、"沪深300"、"某公司财务数据"、"期货行情"、"基金净值"、"宏观数据"、"GDP"、"CPI"、"人民币汇率"、"比特币价格"等任何中国金融数据查询。

- Skill: `knownasnaffy/akshare-finance-3` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/akshare-finance-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/akshare-finance-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/knownasnaffy/akshare-finance-3

---





### Credential Fixture Review

`python scripts/_secrets_inline.py` is review material for the `AKShare Finance Skill` skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.

# AKShare Finance Skill

基于 AKShare 1.18.39，支持查询：中国 A股、指数、期货、期权、债券、基金、外汇、宏观数据、数字货币。

## 核心脚本

**`scripts/akshare_query.py`** — 所有查询统一入口

```bash
python3 /root/.openclaw/workspace/skills/akshare-finance/scripts/akshare_query.py <接口名> [参数...]
```

## 常用接口速查

### 股票行情
```bash
# 实时行情（单只或多只）
python3 akshare_query.py stock_zh_a_spot_em   # 全市场实时行情

# 历史K线
python3 akshare_query.py stock_zh_a_hist "000001.SZ" 1  # 日K
python3 akshare_query.py stock_zh_a_hist "000001.SZ" 300  # 最近300日

# 个股信息
python3 akshare_query.py stock_individual_info_em "000001.SZ"
```

### 指数
```bash
# 沪深300、上证指数等实时行情
python3 akshare_query.py stock_zh_index_spot_em

# 指数历史K线
python3 akshare_query.py stock_zh_index_hist_csindex "000300.SH" 1
```

### 财务报表
```bash
# 利润表
python3 akshare_query.py stock_financial_analysis_indicator "000001.SZ" "报告日期"
```

### 基金
```bash
# 基金净值
python3 akshare_query.py fund_open_fund_info_em "000001"

# 公募基金列表
python3 akshare_query.py fund_fund_info_sina
```

### 期货/大宗商品
```bash
# 商品期货行情
python3 akshare_query.py futures_goods_index_en

# 贵金属（黄金、白银）
python3 akshare_query.py futures precious metal
```

### 宏观数据
```bash
# GDP
python3 akshare_query.py macro_china_gdp

# CPI/PPI
python3 akshare_query.py macro_china_cpi
python3 akshare_query.py macro_china_ppi
```

### 外汇与汇率
```bash
# 人民币汇率
python3 akshare_query.py forex_rmb_iist

# 美元指数
python3 akshare_query.py currency_index
```

### 债券
```bash
# 企业债
python3 akshare_query.py bond_china_comparison
```

### 数字货币
```bash
# 比特币实时行情
python3 akshare_query.py coin_bitget
```

## 执行流程

1. 解析用户需求 → 确定 AKShare 接口名
2. 构造参数（股票代码、时间范围等）
3. 调用 `akshare_query.py` 执行
4. 整理输出，以可读格式返回给用户

## 股票代码格式

- A股：**`000001.SZ`**（深圳）、**`600001.SH`**（上海）
- 指数：**`000300.SH`**（沪深300）、**`000001.SH`**（上证指数）
- 注意：必须带 `.SZ` / `.SH` 后缀

## 注意事项

- AKShare 为爬虫数据，接口稳定性依赖源网站，偶有失败可重试
- 实时行情一般在交易日 9:30-15:00 更新
- 历史数据建议指定 `adjust` 参数（"qfq"=前复权，"hfq"=后复权）
- 财务数据 T日发布，通常 T+1 可查

## 完整接口列表

见 `references/akshare_api_list.md`，按类别整理了 AKShare 所有接口及其参数说明。