AKShare One

中文 | English

AKShare One is a data interface for obtaining Chinese A-shares, based on AKShare. It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.

✨ Features

📊 Unified stock code formats across data sources
🏗️ Standardized return data structures
🛠️ Simplified API parameter design
⏱️ Automatic timestamp and adjustment handling

🚀 Core Features

Function	Interface
Historical data	`get_hist_data`
Real-time quotes	`get_realtime_data`
Stock news	`get_news_data`
Financial data	`get_balance_sheet`/`get_income_statement`/`get_cash_flow`
Futures data	`get_futures_hist_data`/`get_futures_realtime_data`
Options data	`get_options_chain`/`get_options_realtime`/`get_options_hist`
Internal transactions	`get_inner_trade_data`
Basic stock info	`get_basic_info`
Financial metrics	`get_financial_metrics`
Technical indicators	See indicators.py

📦 Quick Installation

pip install akshare-one

💻 Usage Example

from akshare_one import get_hist_data
from akshare_one.indicators import get_sma

# Get historical data
df = get_hist_data(symbol="600000", interval="day", adjust="hfq")

# Calculate 20-day Simple Moving Average
df_sma = get_sma(df, window=20)

📚 Documentation

Full API documentation is now available on GitHub Pages:

https://zwldarren.github.io/akshare-one/

🧪 Testing

Tests run fully offline by default. Test modules that call live upstream data providers (EastMoney, Sina, XueQiu, the exchanges) are skipped unless you opt in, because those endpoints apply aggressive rate limits and a full run can get your IP temporarily blocked:

pytest                    # offline unit tests only
pytest --run-network      # include live-provider tests

🧩 Public interface

The public surface is akshare_one and akshare_one.indicators. Everything under akshare_one.modules is internal and may change without a deprecation cycle.

Each domain's output columns are declared in exactly one place, akshare_one.modules.<domain>.schema. Every provider's frame is projected onto those columns, so a documented column is always present — NaN when the selected source cannot supply it — and always in the documented order.

⚠️ Data source notes

Realtime quotes and basic info fall back across several EastMoney hosts, because push2.eastmoney.com intermittently returns 502 (notably from outside mainland China).
xueqiu realtime quotes need an xq_a_token cookie that XueQiu no longer hands to anonymous clients, and XueQiu returns 418 once rate-limited.
get_options_chain returns the option contract list with the market-data columns left empty; use get_options_realtime / get_options_hist for prices.
get_futures_main_contracts() reflects static exchange snapshots and may be slow on the first call (CFFEX); the result is cached for 24 hours.

Metadata

Release files for akshare-one 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for akshare-one 0.5.0
File	Size	Uploaded
akshare_one-0.5.0.tar.gz	42.0 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for akshare-one 0.5.0
File	Interpreter	ABI	Platform	Reset
akshare_one-0.5.0-py3-none-any.whl 65.1 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 107.2 kB

Release files / akshare_one-0.5.0.tar.gz

Download URL	akshare_one-0.5.0.tar.gz
Size	42.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`872739261a428ee660c8acda2aa724738cc316198eed993339fec2b41740df14`
BLAKE2b-256 checksum How to use checksums	`cf51160d1116d0458d5a553b337724b9f74db14124b086441a81d244e336c95a`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/zwldarren/akshare-one
Publishing commit: github.com/zwldarren/akshare-one/tree/896bb57354e32f6463983fd33b52f8e6d433b52b

Workflow

Publishing configuration: github.com/zwldarren/akshare-one/blob/896bb57354e32f6463983fd33b52f8e6d433b52b/.github/workflows/release.yml
Publishing logs: github.com/zwldarren/akshare-one/actions/runs/35426903800/attempts/1

Artifact

Subject: akshare_one-0.5.0.tar.gz
SHA-256 checksum: 872739261a428ee660c8acda2aa724738cc316198eed993339fec2b41740df14 Verifying attestations

Release files / akshare_one-0.5.0-py3-none-any.whl

Download URL	akshare_one-0.5.0-py3-none-any.whl
Size	65.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f1febcad2337570952884565408edf73021eba26f50688b758071ff3b4a5d099`
BLAKE2b-256 checksum How to use checksums	`336a2f5f9377ac1a1c2961ef91bdda016dc70bb98f0d5e081d49986c5373a774`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/zwldarren/akshare-one
Publishing commit: github.com/zwldarren/akshare-one/tree/896bb57354e32f6463983fd33b52f8e6d433b52b

Workflow

Publishing configuration: github.com/zwldarren/akshare-one/blob/896bb57354e32f6463983fd33b52f8e6d433b52b/.github/workflows/release.yml
Publishing logs: github.com/zwldarren/akshare-one/actions/runs/35426903800/attempts/1

Artifact

Subject: akshare_one-0.5.0-py3-none-any.whl
SHA-256 checksum: f1febcad2337570952884565408edf73021eba26f50688b758071ff3b4a5d099 Verifying attestations