Skip to main content

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, Tonghuashun, 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 else is internal and may change without a deprecation cycle — that includes akshare_one.modules, and the per-source clients akshare_one.eastmoney and akshare_one.ths.

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.
  • ths talks to Tonghuashun's public HTTP endpoints, which need no login. It serves one security per request, so realtime quotes need a symbol; its daily history is long but arrives one year per request, and its intraday series keeps only a short window. Realtime quotes carry the upstream quote time, and the SSE Composite is addressed as 1A0001 (sh000001 is mapped to it).
  • 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.6.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.6.0
File Size Uploaded Provenance Actions
akshare_one-0.6.0.tar.gz 54.4 kB With provenance Details for akshare_one-0.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for akshare-one 0.6.0
File Interpreter ABI Platform Actions
akshare_one-0.6.0-py3-none-any.whl Python 3 none any Details for akshare_one-0.6.0-py3-none-any.whl

Total release size: 136.2 kB

Release files / akshare_one-0.6.0.tar.gz

Download URL akshare_one-0.6.0.tar.gz
Size 54.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f318fa6918345e4ed1df142db7193aaa276f9aa9fd62a2e7b2a1d91f829dbc9b
BLAKE2b-256 checksum
How to use checksums
9fa056ad412470eb56a017d055c137b35975d51c82be30d44f3939063d816cac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

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

Download URL akshare_one-0.6.0-py3-none-any.whl
Size 81.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
53c2f74f653709c50bb4763fd8b17bd9db86f6877d9f5857358991c31938c0bb
BLAKE2b-256 checksum
How to use checksums
07a76956641108bf728e0b2793046363164f763b0b6a8a005f32056bda07c22e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Security for akshare-one 0.6.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for akshare_one-0.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.6.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page