Convert Figma logo to code with AI

akfamily logoakshare

AKShare is an elegant and simple financial data interface library for Python, built for human beings! 开源财经数据接口库

8,990
1,847
8,990
0

Top Related Projects

8,990

AKShare is an elegant and simple financial data interface library for Python, built for human beings! 开源财经数据接口库

12,780

TuShare is a utility for crawling historical data of China stocks

开源的金融投资数据提取工具,专注在各类网站上爬取数据,并通过简单易用的API方式使用

Quick Overview

AKShare is an open-source Python financial data interface library, designed to help users easily obtain financial market data. It provides a wide range of data sources, including stock markets, bonds, commodities, currencies, and macroeconomic indicators, making it a comprehensive tool for financial analysis and research.

Pros

  • Extensive data coverage across various financial markets and instruments
  • Regular updates to ensure data accuracy and relevance
  • Easy-to-use API with consistent function naming conventions
  • Well-documented with examples for each data interface

Cons

  • Primarily focused on Chinese financial markets, which may limit its usefulness for global investors
  • Dependency on external data sources may lead to occasional data availability issues
  • Learning curve for users unfamiliar with Python or financial data structures
  • Some functions may require additional parameters or authentication for certain data sources

Code Examples

Fetching stock data:

import akshare as ak

stock_zh_a_hist_df = ak.stock_zh_a_hist(symbol="000001", period="daily", start_date="20220101", end_date="20220331", adjust="")
print(stock_zh_a_hist_df)

Getting currency exchange rates:

import akshare as ak

currency_latest_df = ak.currency_latest()
print(currency_latest_df)

Retrieving macroeconomic data:

import akshare as ak

macro_china_gdp_yearly_df = ak.macro_china_gdp_yearly()
print(macro_china_gdp_yearly_df)

Getting Started

To get started with AKShare, follow these steps:

  1. Install AKShare using pip:

    pip install akshare
    
  2. Import the library in your Python script:

    import akshare as ak
    
  3. Use the desired function to fetch data:

    # Example: Get stock data
    stock_data = ak.stock_zh_a_hist(symbol="000001", period="daily", start_date="20220101", end_date="20220331", adjust="")
    print(stock_data)
    

For more detailed information and examples, refer to the official documentation at https://akshare.akfamily.xyz/.

Competitor Comparisons

8,990

AKShare is an elegant and simple financial data interface library for Python, built for human beings! 开源财经数据接口库

Pros of AKShare

  • More comprehensive documentation and examples
  • Larger community and more frequent updates
  • Broader range of financial data sources supported

Cons of AKShare

  • Potentially more complex API due to wider feature set
  • May have higher resource requirements for full functionality
  • Steeper learning curve for new users

Code Comparison

AKShare:

import akshare as ak

stock_zh_a_spot_df = ak.stock_zh_a_spot()
print(stock_zh_a_spot_df)

AKShare>:

import akshare as ak

stock_zh_a_spot_df = ak.stock_zh_a_spot()
print(stock_zh_a_spot_df.head())

The code snippets are nearly identical, with AKShare> using the head() method to display only the first few rows of data, which can be more manageable for large datasets.

Both libraries provide similar functionality for accessing Chinese A-share stock data, but AKShare offers a more extensive set of features and data sources. AKShare> may be more suitable for users who prefer a simpler interface or have more limited requirements. The choice between the two depends on the specific needs of the project and the user's familiarity with financial data analysis.

12,780

TuShare is a utility for crawling historical data of China stocks

Pros of Tushare

  • More established and mature project with a longer history
  • Offers a wider range of data sources, including financial and economic data
  • Provides both free and premium data services

Cons of Tushare

  • Some features require a paid subscription
  • Documentation is primarily in Chinese, which may be challenging for non-Chinese speakers
  • Less frequent updates compared to AKShare

Code Comparison

Tushare:

import tushare as ts

# Get stock data
df = ts.get_hist_data('000001')
print(df.head())

AKShare:

import akshare as ak

# Get stock data
stock_zh_a_hist_df = ak.stock_zh_a_hist(symbol="000001", period="daily", start_date="20200101", end_date="20210101", adjust="")
print(stock_zh_a_hist_df.head())

Both libraries offer similar functionality for retrieving stock data, but AKShare's method includes more parameters for customization. Tushare's syntax is slightly more concise, while AKShare provides more flexibility in specifying date ranges and adjustments.

开源的金融投资数据提取工具,专注在各类网站上爬取数据,并通过简单易用的API方式使用

Pros of OpenData

  • More focused on specific Chinese financial data sources
  • Provides detailed documentation for each data source
  • Includes some unique datasets not available in AKShare

Cons of OpenData

  • Less frequently updated compared to AKShare
  • Smaller community and fewer contributors
  • More limited in scope, primarily covering Chinese markets

Code Comparison

OpenData:

from OpenData import Stock

# Get daily price data for a stock
df = Stock.get_k_data('000001', start='2020-01-01', end='2020-12-31')

AKShare:

import akshare as ak

# Get daily price data for a stock
df = ak.stock_zh_a_daily(symbol="000001", start_date="20200101", end_date="20201231")

Both libraries provide similar functionality for fetching stock data, but AKShare offers a wider range of data sources and more frequent updates. OpenData focuses more on specific Chinese financial data and provides detailed documentation for each source. AKShare has a larger community and more diverse data offerings, while OpenData may be more suitable for users specifically interested in Chinese market data with comprehensive documentation.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

欢迎加入专注于财经数据和量化投资的知识社区,请点击了解更多

相关视频教程已经发布:《AKShare-初阶-使用教学》、《AKShare-初阶-实战应用》、《AKShare-源码解析》、《开源项目巡礼》,详情请访问课程查看更多课程信息!

AKQuant 量化教程请访问:利用 PyBroker 进行量化投资

本次发布 AKTools 作为 AKShare 的 HTTP API 版本, 突破 Python 语言的限制,欢迎各位小伙伴试用并提出更好的意见或建议! 点击 AKTools 查看使用指南。另外提供 awesome-data 方便各位小伙伴查询各种数据源。

AKShare Logo

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

Overview

AKShare requires Python(64 bit) 3.8 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]

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

Communication

Welcome to join the 数据科学实战 knowledge planet to learn more about quantitative investment, please visit 数据科学实战 for more information:

data science

Pay attention to 数据科学实战 WeChat Official Accounts to get the AKShare updated info:

ds

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. Tutorial
  4. Data Dict
  5. 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},
    title = {AKShare},
    year = {2019},
    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 99期货网站;

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 Oxford-Man Institute 网站;

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 南华期货网站;

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 真气网网站;

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 IT桔子网站;

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 Currencyscoop 网站;

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

Thanks for the tutorials provided by 微信公众号: Python大咖谈.

Backer and Sponsor

jetbrains