AKShare Financial Data Retrieval

Task Objectives

This Skill is used to: Retrieve full-category financial market data via AKShare interfaces
Capabilities include: Data of stocks, futures, options, funds, foreign exchange, bonds, indices, cryptocurrencies, macroeconomics, etc.
Trigger conditions: When users mention AKShare or need to obtain various financial data

Preparations

Dependency Description: Install the akshare library (included in dependencies)
Credential Configuration: AKShare requires no registration or API Key, it can be used directly by calling
Environment Requirements: Python 3.9+, it is recommended to update regularly with
```
pip install akshare --upgrade
```

Operation Steps

Standard Process:
1. Confirm Data Requirements — Agent understands user intent (stocks/futures/funds/foreign exchange, etc.)
2. Call Corresponding Script — Select the script according to data type
3. Parse Results — Agent analyzes the returned JSON format data

Script Call Mapping:

Stock Data →

python scripts/stock_data.py --type hist --symbol 000001 --start 20240101 --end 20240131

Futures Data →

python scripts/futures_data.py --type daily --exchange CFFEX --start 20240101 --end 20240131

Fund Data →

python scripts/fund_data.py --type etf --symbol 510300

Foreign Exchange Data →

python scripts/forex_data.py --type spot --symbol usd

Macroeconomic Data →
```
python scripts/macro_data.py --type gdp
```

Cryptocurrency Data →

python scripts/crypto_data.py --type price --symbol BTC/USDT

Optional Branches:
- When multiple targets are needed: Use commas to separate multiple codes
- When specifying a period: Use the
```
--period
```
  parameter (daily/weekly/monthly)
- When needing adjusted data: Use the
```
--adjust
```
  parameter (qfq/hfq/empty value)

Usage Examples

Example 1: Retrieve Stock Historical K-line
- Scenario/Input: User says: "Get the daily K-line data of Kweichow Moutai in 2024"
- Expected Output: Returns OHLCV data such as date, opening price, highest price, lowest price, closing price, trading volume, etc.
- Key Points: Call
```
python scripts/stock_data.py --type hist --symbol 600519 --start 20240101 --end 20241231 --period daily --adjust qfq
```
Example 2: Retrieve Futures Data
- Scenario/Input: User says: "Check the CSI 300 stock index futures data"
- Expected Output: Returns K-line data, open interest, trading volume and other information of futures contracts
- Key Points: Call
```
python scripts/futures_data.py --type daily --symbol IF2406 --start 20240101 --end 20240131
```
Example 3: Retrieve Fund Data
- Scenario/Input: User says: "Query the market of CSI 300 ETF"
- Expected Output: Returns real-time market or historical net value data of the ETF
- Key Points: Call
```
python scripts/fund_data.py --type etf --symbol 510300
```
Example 4: Retrieve Macroeconomic Data
- Scenario/Input: User says: "Check China's GDP data"
- Expected Output: Returns historical GDP data and the latest value
- Key Points: Call
```
python scripts/macro_data.py --type gdp
```

Detailed Data Classification

Stock Data (A-shares/Hong Kong Stocks/US Stocks)

Real-time Market:
```
ak.stock_zh_a_spot_em()
```
- Real-time market of all A-shares

Historical K-line:

ak.stock_zh_a_hist(symbol, period, start_date, end_date, adjust)

Minute K-line:

ak.stock_zh_a_hist_min_em(symbol, period, start_date, end_date)

Individual Stock Information:
```
ak.stock_individual_info_em(symbol)
```
- Basic information, market value, industry, etc.
Financial Data:
```
ak.stock_fundamental(symbol)
```
- Fundamental data
Valuation Indicators:
```
ak.stock_valuation(symbol)
```
- PE, PB, etc.
Hong Kong Stocks Data:
```
ak.stock_hk_spot_em()
```
,
```
ak.stock_hk_hist()
```

US Stocks Data:

ak.stock_us_daily(symbol)

ak.stock_us_spot_em()

Futures Data

Futures Market:
```
ak.futures_zh_spot()
```
- Real-time market

Futures K-line:

get_futures_daily(start_date, end_date, market)

- By exchange

Inventory Data:
```
ak.futures_inventory_99(symbol)
```
- Futures inventory

Fund Data

ETF Market:
```
ak.fund_etf_spot_em()
```
- Real-time ETF market

ETF History:

ak.fund_etf_hist_em(symbol, period, start_date, end_date, adjust)

Open-end Funds:
```
ak.fund_open_fund_daily_em(symbol)
```
- Daily net value
Fund Ratings:
```
ak.fund_rating_all()
```
- Fund rating information

Options Data

Options History:
```
ak.option_hist_dce(symbol)
```
- Exchange options data
ETF Options:
```
ak.option_sse_spot_price(symbol)
```
- SSE 50 ETF options

Bond Data

Convertible Bonds:
```
ak.bond_zh_cov()
```
- List of convertible bonds
Convertible Bond K-line:
```
ak.bond_zh_hs_cov_daily(symbol)
```
- Historical data of convertible bonds
Bond Quotes:
```
ak.bond_spot_quote()
```
- Spot quotes of Chinese bonds

Foreign Exchange and Precious Metals

Foreign Exchange Market:
```
ak.forex_spot_em()
```
- Real-time foreign exchange market
Exchange Rate Data:
```
ak.forex_usd_cny()
```
- USD/CNY exchange rate
Precious Metals:
```
ak.metals_gold()
```
- International gold price

Index Data

A-share Indices:
```
ak.stock_zh_index_daily_em(symbol)
```
- Historical index data
Index Components:
```
ak.index_stock_cons_csindex(symbol)
```
- Index constituent stocks

Cryptocurrencies

Currency List:
```
ak.crypto_binance_symbols()
```
- Binance trading pairs
Real-time Price:
```
ak.crypto_binance_btc_usdt_spot()
```
- BTC/USDT price

K-line Data:

ak.crypto_binance_btc_usdt_kline(period)

- Cryptocurrency K-line

Macroeconomics

China's GDP:

ak.macro_china_gdp()

ak.macro_china_gdp_yearly()

CPI Data:

ak.macro_china_cpi_yearly()

ak.macro_china_cpi()

PMI Data:
```
ak.macro_china_pmi()
```

US Data:

ak.macro_usa_non_farm()

ak.macro_usa_cpi_monthly()

Featured Data

Dragon and Tiger List:
```
ak.stock_lhb_detail_em(start_date, end_date)
```
- Details of Dragon and Tiger List

Margin Trading:

ak.stock_margin_sse(start_date, end_date)

- Margin trading data

Northbound Capital:
```
ak.stock_hsgt_hist_em(symbol)
```
- Stock Connect data
Shareholder Data:
```
ak.stock_gdfx_top_10_em(symbol, date)
```
- Top 10 shareholders
Sector Market:
```
ak.stock_board_industry_name_em()
```
- Industry sectors
Restricted Stock Unlocking:
```
ak.stock_restricted_release_queue_em(symbol)
```
- Restricted stock unlocking queue
Capital Flow:
```
ak.stock_market_fund_flow()
```
- Market capital flow

Resource Index

Scripts:

scripts/stock_data.py (Purpose & Parameters: Retrieve stock K-line/market/financial data, supports --type/--symbol/--start/--end/--period/--adjust)
scripts/futures_data.py (Purpose & Parameters: Retrieve futures data, supports --type/--symbol/--exchange/--start/--end)
scripts/fund_data.py (Purpose & Parameters: Retrieve fund data, supports --type/--symbol/--start/--end)
scripts/forex_data.py (Purpose & Parameters: Retrieve foreign exchange and precious metals data, supports --type/--symbol)
scripts/macro_data.py (Purpose & Parameters: Retrieve macroeconomic data, supports --type)
scripts/crypto_data.py (Purpose & Parameters: Retrieve cryptocurrency data, supports --type/--symbol/--period)
scripts/index_data.py (Purpose & Parameters: Retrieve index data, supports --type/--symbol/--start/--end)
scripts/option_data.py (Purpose & Parameters: Retrieve options data, supports --type/--symbol)
scripts/bond_data.py (Purpose & Parameters: Retrieve bond data, supports --type/--symbol)
scripts/special_data.py (Purpose & Parameters: Retrieve featured data such as Dragon and Tiger List/margin trading/northbound capital, supports --type/--symbol/--start/--end)

Reference Documents:

Stock Data Documentation (When to read: Need to check parameter descriptions of stock-related APIs)
Futures Data Documentation (When to read: Need to check parameter descriptions of futures-related APIs)
Fund Data Documentation (When to read: Need to check parameter descriptions of fund-related APIs)
Macroeconomic Documentation (When to read: Need to check parameter descriptions of macro data APIs)
AKShare Official Documentation (When to read: Need to check the latest API documentation)

Notes

AKShare requires no registration or API Key, it can be used directly by calling
A-share stock code format: Pure numeric code (e.g., 000001, 600519), without market prefix
Hong Kong stock code format: Pure numeric code (e.g., 00700)
US stock code format: English code (e.g., AAPL, TSLA)
Data Column Names: A-share data uses Chinese column names, US/Hong Kong stock data uses English column names
It is recommended to update AKShare regularly:
```
pip install akshare --upgrade
```
Due to changes in upstream data sources, interfaces are updated frequently; try updating the version first when encountering errors
Scripts return JSON format data, and the Agent is responsible for parsing and converting it into user-friendly display
Non-Python users can use AKTools HTTP API encapsulation
The data is for academic research only and does not constitute investment advice

Quick Reference

Function Naming Rules

{asset_type}_{market}_{data_type}_{data_source}

Asset type:
```
stock
```
(stocks),
```
futures
```
(futures),
```
fund
```
(funds),
```
bond
```
(bonds),
```
forex
```
(foreign exchange),
```
option
```
(options),
```
macro
```
(macroeconomics),
```
index
```
(indices)
Market:
```
zh
```
(China),
```
us
```
(US),
```
hk
```
(Hong Kong), or exchange code
Data type:
```
spot
```
(real-time),
```
hist
```
(historical),
```
daily
```
(daily),
```
minute
```
(minute)
Data source:
```
em
```
(East Money),
```
sina
```
(Sina Finance), exchange abbreviation

Adjustment Types

```
""
```
- No adjustment
```
"qfq"
```
- Forward adjustment
```
"hfq"
```
- Backward adjustment

Period Types

```
"daily"
```
- Daily
```
"weekly"
```
- Weekly
```
"monthly"
```
- Monthly
```
"1"
```
,
```
"5"
```
,
```
"15"
```
,
```
"30"
```
,
```
"60"
```
- Minute ",

akshare

NPX Install

Tags

SKILL.md Content (Chinese)