Skip to main content

资源分享:对于想了解更多财经数据与量化投研的小伙伴,推荐一个专注于财经数据和量化研究的知识社区。 该社区提供相关文档和视频学习资源,汇集了各类财经数据源和量化投研工具的使用经验。 有兴趣深入学习的朋友可点此了解更多,也推荐大家关注微信公众号【数据科学实战】。

重磅推荐:AKQuant 是一款专为 量化投研 (Quantitative Research) 打造的高性能量化回测框架。它以 Rust 铸造极速撮合内核, 以 Python 链接数据与 AI 生态,旨在为量化投资者提供可靠高效的量化投研解决方案。参见AKQuant

工具推荐:期魔方是一款本地化期货量化分析工具,适合数据分析爱好者使用。无需复杂部署,支持数据分析和机器学习功能,研究功能免费开放。 如需了解更多信息可访问期魔方

AKShare Logo

PyPI - Python Version PyPI PyPI Downloads Documentation Status Ruff akshare Actions Status MIT Licence code style: prettier

Overview

AKShare requires Python(64 bit) 3.9 or higher and aims to simplify the process of fetching financial data.

Write less, get more!

Installation

General

pip install akshare --upgrade

China

pip install akshare -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com  --upgrade

PR

Please check out Documentation if you want to contribute to AKShare

Docker

Pull images

docker pull registry.cn-shanghai.aliyuncs.com/akfamily/aktools:jupyter

Run Container

docker run -it registry.cn-shanghai.aliyuncs.com/akfamily/aktools:jupyter python

Test

import akshare as ak

print(ak.__version__)

Usage

Data

Code:

import akshare as ak

stock_zh_a_hist_df = ak.stock_zh_a_hist(symbol="000001", period="daily", start_date="20170301", end_date='20231022', adjust="")
print(stock_zh_a_hist_df)

Output:

      日期          开盘   收盘    最高  ...  振幅   涨跌幅  涨跌额  换手率
0     2017-03-01   9.49   9.49   9.55  ...  0.84  0.11  0.01  0.21
1     2017-03-02   9.51   9.43   9.54  ...  1.26 -0.63 -0.06  0.24
2     2017-03-03   9.41   9.40   9.43  ...  0.74 -0.32 -0.03  0.20
3     2017-03-06   9.40   9.45   9.46  ...  0.74  0.53  0.05  0.24
4     2017-03-07   9.44   9.45   9.46  ...  0.63  0.00  0.00  0.17
          ...    ...    ...    ...  ...   ...   ...   ...   ...
1610  2023-10-16  11.00  11.01  11.03  ...  0.73  0.09  0.01  0.26
1611  2023-10-17  11.01  11.02  11.05  ...  0.82  0.09  0.01  0.25
1612  2023-10-18  10.99  10.95  11.02  ...  1.00 -0.64 -0.07  0.34
1613  2023-10-19  10.91  10.60  10.92  ...  3.01 -3.20 -0.35  0.61
1614  2023-10-20  10.55  10.60  10.67  ...  1.51  0.00  0.00  0.27
[1615 rows x 11 columns]

Search

AKShare ships an offline interface registry, so you can look up an interface by keyword without leaving Python and without any network request. This is especially handy for LLM-driven programs that need to resolve a description into a callable interface name.

Code:

import akshare as ak

search_df = ak.search("可转债 实时行情", limit=5)
print(search_df)

# full metadata of a single interface: params, output columns and a usage example
interface_info_dict = ak.interface_info("bond_cb_jsl")
print(interface_info_dict)

Output:

                      接口名    类目                                                       描述  有无文档   匹配分
0             bond_cb_jsl  bond  集思录可转债实时数据,包含行情数据(涨跌幅,成交量和换手率等)及可转债基本信息(转股价,溢价率和到期收益率等)  True  27.0
1      bond_zh_hs_cov_min  bond                                           东方财富网-可转债-分时行情  True  20.0
2  bond_zh_hs_cov_pre_min  bond                                      东方财富网-可转债-分时行情-盘前分时  True  20.0
3     bond_cov_comparison  bond                                   东方财富网-行情中心-债券市场-可转债比价表  True  17.0
4        fund_etf_spot_em  fund                                            东方财富-ETF 实时行情  True  17.0

Passing a full interface name always ranks that interface first, which makes it a reliable way to confirm a half-remembered name. Note this is keyword matching rather than semantic search — see the interface search docs for what it can and cannot do.

Plot

Code:

import akshare as ak
import mplfinance as mpf  # Please install mplfinance as follows: pip install mplfinance

stock_us_daily_df = ak.stock_us_daily(symbol="AAPL", adjust="qfq")
stock_us_daily_df = stock_us_daily_df.set_index(["date"])
stock_us_daily_df = stock_us_daily_df["2020-04-01": "2020-04-29"]
mpf.plot(stock_us_daily_df, type="candle", mav=(3, 6, 9), volume=True, show_nontrading=False)

Output:

KLine

Features

  • Easy of use: Just one line code to fetch the data;
  • Extensible: Easy to customize your own code with other application;
  • Powerful: Python ecosystem.

Tutorials

  1. Overview
  2. Installation
  3. Interface Search
  4. Tutorial
  5. Data Dict
  6. Subjects

Contribution

AKShare is still under developing, feel free to open issues and pull requests:

  • Report or fix bugs
  • Require or publish interface
  • Write or fix documentation
  • Add test cases

Notice: We use Ruff to format the code

Statement

  1. All data provided by AKShare is just for academic research purpose;
  2. The data provided by AKShare is for reference only and does not constitute any investment proposal;
  3. Any investor based on AKShare research should pay more attention to data risk;
  4. AKShare will insist on providing open-source financial data;
  5. Based on some uncontrollable factors, some data interfaces in AKShare may be removed;
  6. Please follow the relevant open-source protocol used by AKShare;
  7. Provide HTTP API for the person who uses other program language: AKTools.

Show your style

Use the badge in your project's README.md:

[![Data: akshare](https://img.shields.io/badge/Data%20Science-AKShare-green)](https://github.com/akfamily/akshare)

Using the badge in README.rst:

.. image:: https://img.shields.io/badge/Data%20Science-AKShare-green
    :target: https://github.com/akfamily/akshare

Looks like this:

Data: akshare

Citation

Please use this bibtex if you want to cite this repository in your publications:

@misc{akshare,
    author = {Albert King and Yaojie Zhang},
    title = {AKShare},
    year = {2022},
    publisher = {GitHub},
    journal = {GitHub repository},
    howpublished = {\url{https://github.com/akfamily/akshare}},
}

Acknowledgement

Special thanks FuShare for the opportunity of learning from the project;

Special thanks TuShare for the opportunity of learning from the project;

Thanks for the data provided by 东方财富网站;

Thanks for the data provided by 新浪财经网站;

Thanks for the data provided by 金十数据网站;

Thanks for the data provided by 生意社网站;

Thanks for the data provided by 中国银行间市场交易商协会网站;

Thanks for the data provided by 99期货网站;

Thanks for the data provided by 中国外汇交易中心暨全国银行间同业拆借中心网站;

Thanks for the data provided by 和讯财经网站;

Thanks for the data provided by DACHENG-XIU 网站;

Thanks for the data provided by 上海证券交易所网站;

Thanks for the data provided by 深证证券交易所网站;

Thanks for the data provided by 北京证券交易所网站;

Thanks for the data provided by 中国金融期货交易所网站;

Thanks for the data provided by 上海期货交易所网站;

Thanks for the data provided by 大连商品交易所网站;

Thanks for the data provided by 郑州商品交易所网站;

Thanks for the data provided by 上海国际能源交易中心网站;

Thanks for the data provided by Timeanddate 网站;

Thanks for the data provided by 河北省空气质量预报信息发布系统网站;

Thanks for the data provided by Economic Policy Uncertainty 网站;

Thanks for the data provided by 申万指数网站;

Thanks for the data provided by 真气网网站;

Thanks for the data provided by 财富网站;

Thanks for the data provided by 中国证券投资基金业协会网站;

Thanks for the data provided by Expatistan 网站;

Thanks for the data provided by 北京市碳排放权电子交易平台网站;

Thanks for the data provided by 国家金融与发展实验室网站;

Thanks for the data provided by 义乌小商品指数网站;

Thanks for the data provided by 百度迁徙网站;

Thanks for the data provided by 思知网站;

Thanks for the data provided by Currencyscoop 网站;

Thanks for the data provided by 新加坡交易所网站;

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

akshare-1.18.88.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

akshare-1.18.88-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file akshare-1.18.88.tar.gz.

File metadata

  • Download URL: akshare-1.18.88.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for akshare-1.18.88.tar.gz
Algorithm Hash digest
SHA256 48d362d64a49bc8dea55b9422e2285d3f4c75b540b6196c0510e43196cbcf0b0
MD5 43cfb4751a220bdba1a0da4228a3ab55
BLAKE2b-256 57602f3bea05e3ca4dae32741ae945f39fa76c3acf3b36a925e68f6cc74a2732

See more details on using hashes here.

File details

Details for the file akshare-1.18.88-py3-none-any.whl.

File metadata

  • Download URL: akshare-1.18.88-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for akshare-1.18.88-py3-none-any.whl
Algorithm Hash digest
SHA256 ba0b06ea2d341122e2ef8ed5e4982ff5925f01111e63d7940c8a01aa684578c0
MD5 252ebfd153f59bb65c020e7c04c9ef6d
BLAKE2b-256 8e24f4a3d9d58993a67bf3ead06e44ad9dcd062eaa1e2b719be4be8e7e2646cf

See more details on using hashes here.

Release history Release notifications | RSS feed

1.18.94

2 files

1.18.93

2 files

1.18.92

2 files

1.18.91

2 files

1.18.90

2 files

This release

1.18.88 This release

2 files

1.18.87

2 files

1.18.86

2 files

1.18.85

2 files

1.18.84

2 files

1.18.83

2 files

1.18.82

2 files

1.18.81

2 files

1.18.80

2 files

1.18.79

2 files

1.18.78

2 files

1.18.77

2 files

1.18.76

2 files

1.18.75

2 files

1.18.74

2 files

1.18.73

2 files

1.18.72

2 files

1.18.71

2 files

1.18.70

2 files

1.18.69

2 files

1.18.68

2 files

1.18.67

2 files

1.18.66

2 files

1.18.65

2 files

1.18.64

2 files

1.18.63

2 files

1.18.62

2 files

1.18.61

2 files

1.18.60

2 files

1.18.59

2 files

1.18.58

2 files

1.18.57

2 files

1.18.56

2 files

1.18.55

2 files

1.18.54

2 files

1.18.53

2 files

1.18.52

2 files

1.18.51

2 files

1.18.50

2 files

1.18.49

2 files

1.18.48

2 files

1.18.47

2 files

1.18.46

2 files

1.18.45

2 files

1.18.44

2 files

1.18.43

2 files

1.18.42

2 files

1.18.41

2 files

1.18.40

2 files

1.18.39

2 files

1.18.38

2 files

1.18.37

2 files

1.18.36

2 files

1.18.35

2 files

1.18.34

2 files

1.18.33

2 files

1.18.32

2 files

1.18.31

2 files

1.18.30

2 files

1.18.29

2 files

1.18.28

2 files

1.18.27

2 files

1.18.26

2 files

1.18.25

2 files

1.18.24

2 files

1.18.23

2 files

1.18.22

2 files

1.18.21

2 files

1.18.20

2 files

1.18.19

2 files

1.18.18

2 files

1.18.16

2 files

1.18.15

2 files

1.18.14

2 files

1.18.13

2 files

1.18.12

2 files

1.18.11

2 files

1.18.10

2 files

1.18.9

2 files

1.18.8

2 files

1.18.7

2 files

1.18.6

2 files

1.18.5

2 files

1.18.4

2 files

1.18.3

2 files

1.18.2

2 files

1.18.1

2 files

1.17.99

2 files

1.17.98

2 files

1.17.97

2 files

1.17.96

2 files

1.17.95

2 files

1.17.94

2 files

1.17.93

2 files

1.17.92

2 files

1.17.91

2 files

1.17.90

2 files

1.17.89

2 files

1.17.88

2 files

1.17.87

2 files

1.17.86

2 files

1.17.85

2 files

1.17.84

2 files

1.17.83

2 files

1.17.82

2 files

1.17.81

2 files

1.17.80

2 files

1.17.79

2 files

1.17.78

2 files

1.17.77

2 files

1.17.76

2 files

1.17.75

2 files

1.17.74

2 files

1.17.73

2 files

1.17.72

2 files

1.17.71

2 files

1.17.70

2 files

1.17.69

2 files

1.17.68

2 files

1.17.67

2 files

1.17.66

2 files

1.17.65

2 files

1.17.64

2 files

1.17.63

2 files

1.17.62

2 files

1.17.61

2 files

1.17.60

2 files

1.17.59

2 files

1.17.58

2 files

1.17.57

2 files

1.17.56

2 files

1.17.55

2 files

1.17.54

2 files

1.17.53

2 files

1.17.52

2 files

1.17.51

2 files

1.17.50

2 files

1.17.49

2 files

1.17.48

2 files

1.17.47

2 files

1.17.46

2 files

1.17.45

2 files

1.17.44

2 files

1.17.43

2 files

1.17.42

2 files

1.17.41

2 files

1.17.40

2 files

1.17.39

2 files

1.17.38

2 files

1.17.37

2 files

1.17.36

2 files

1.17.35

2 files

1.17.34

2 files

1.17.33

2 files

1.17.32

2 files

1.17.31

2 files

1.17.30

2 files

1.17.29

2 files

1.17.28

2 files

1.17.27

2 files

1.17.26

2 files

1.17.25

2 files

1.17.24

2 files

1.17.23

2 files

1.17.22

2 files

1.17.21

2 files

1.17.20

2 files

1.17.19

2 files

1.17.18

2 files

1.17.17

2 files

1.17.16

2 files

1.17.15

2 files

1.17.14

2 files

1.17.13

2 files

1.17.12

2 files

1.17.11

2 files

1.17.10

2 files

1.17.9

2 files

1.17.8

2 files

1.17.7

2 files

1.17.6

2 files

1.17.5

2 files

1.17.4

2 files

1.17.3

2 files

1.17.2

2 files

1.17.1

2 files

1.16.99

2 files

1.16.98

2 files

1.16.97

2 files

1.16.96

2 files

1.16.95

2 files

1.16.94

2 files

1.16.93

2 files

1.16.92

2 files

1.16.91

2 files

1.16.90

2 files

1.16.89

2 files

1.16.88

2 files

1.16.87

2 files

1.16.86

2 files

1.16.85

2 files

1.16.84

2 files

1.16.83

2 files

1.16.82

2 files

1.16.81

2 files

1.16.80

2 files

1.16.79

2 files

1.16.78

2 files

1.16.77

2 files

1.16.76

2 files

1.16.75

2 files

1.16.74

2 files

1.16.73

2 files

1.16.72

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page