akshare

The akshare skill provides guidance for Chinese financial data access using the AkShare library, a free, open-source Python library for fetching real-time and historical data from Chinese and global markets. It covers A-shares, Hong Kong stocks, US stocks, futures, funds, and macroeconomic indicators, drawing data from exchanges including the Shanghai Stock Exchange, Shenzhen Stock Exchange, and Hong Kong Exchange. It is intended for use when a user requests Chinese market data, stock prices, market analysis, or financial information from Chinese exchanges.

After installing with pip install akshare, the skill demonstrates concrete function calls: real-time A-share data via ak.stock_zh_a_spot_em() and ak.stock_zh_a_spot(), historical daily data via ak.stock_zh_a_hist() with symbol, period, start_date, end_date, and adjust parameters, and the stock list via ak.stock_info_a_code_name(). It covers Hong Kong stocks (ak.stock_hk_spot_em(), ak.stock_hk_hist()), US stocks (ak.stock_us_spot_em()), futures (ak.futures_zh_spot(), ak.futures_zh_hist_sina()), funds (ak.fund_open_fund_info_em()), and macro indicators (ak.macro_china_gdp(), ak.macro_china_cpi(), ak.macro_china_pmi()). Common parameters include period values daily, weekly, and monthly, and adjustment values qfq (前复权), hfq (后复权), and "" (不复权). All functions return pandas DataFrames.

The skill targets developers and analysts working with Chinese and international market data in Python. It offers practical tips: AkShare does not cache data so you should implement your own caching if needed, be mindful of request frequency to avoid rate limiting or being blocked, and implement retry logic because network errors may occur. For deeper coverage it points to bundled references (references/akshare_api.md and references/common_functions.md) and the official documentation at https://akshare.akfamily.xyz/. The bundle also includes scripts such as akshare_tool.py and install_akshare.sh.