akshare

# AKShare (开源财经数据接口库)

[AKShare](https://github.com/akfamily/akshare) is a comprehensive, free Python financial data library covering A-shares, HK/US stocks, futures, options, funds, bonds, forex, and macro data. No registration or API key needed. All functions return `pandas.DataFrame`.

> Docs: https://akshare.akfamily.xyz/

## Install

```bash
pip install akshare --upgrade
```

Requires Python 3.9+ (64-bit).

## Usage pattern

```python
import akshare as ak

df = ak.stock_zh_a_hist(symbol="000001", period="daily", start_date="20240101", end_date="20240630")
print(df)
```

## Function naming convention

```
{asset_class}_{market}_{data_type}_{source}
```

- **asset_class**: `stock`, `futures`, `fund`, `bond`, `forex`, `option`, `macro`, `index`
- **market**: `zh` (China), `us` (US), `hk` (Hong Kong), or exchange codes
- **data_type**: `spot` (real-time), `hist` (historical), `daily`, `minute`
- **source**: `em` (Eastmoney), `sina` (Sina Finance), exchange abbreviations

---

## Stock data (A-shares)

### Real-time quotes — all A-shares

```python
import akshare as ak

df = ak.stock_zh_a_spot_em()
# columns: 序号, 代码, 名称, 最新价, 涨跌幅, 涨跌额, 成交量, 成交额, 振幅, 最高, 最低, 今开, 昨收, 量比, 换手率, 市盈率, 市净率, ...
```

### Historical K-line

```python
df = ak.stock_zh_a_hist(
    symbol="000001",       # stock code (no prefix)
    period="daily",        # "daily", "weekly", "monthly"
    start_date="20240101", # YYYYMMDD
    end_date="20240630",
    adjust=""              # "": no adj, "qfq": forward, "hfq": backward
)
# columns: 日期, 开盘, 收盘, 最高, 最低, 成交量, 成交额, 振幅, 涨跌幅, 涨跌额, 换手率
```

### Minute K-line

```python
df = ak.stock_zh_a_hist_min_em(
    symbol="000001",
    period="5",            # "1", "5", "15", "30", "60"
    start_date="2024-01-02 09:30:00",
    end_date="2024-01-02 15:00:00",
    adjust=""
)
```

### Individual stock info

```python
df = ak.stock_individual_info_em(symbol="000001")
# Returns: 总市值,...