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/get_futures_main_contracts
Options data get_options_chain/get_options_realtime/get_options_expirations/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

Requires Python 3.11.5 or newer. 3.10 was dropped: the security fix for soupsieve (a transitive dependency of akshare) publishes as >=3.11.5, so a 3.10 install could only ever resolve the vulnerable release. Stay on 0.6.1 if you still need 3.10, which reached end of life on 2026-10-01.

💻 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.7.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.7.0
File Size Uploaded Provenance Actions
akshare_one-0.7.0.tar.gz 62.0 kB With provenance Details for akshare_one-0.7.0.tar.gz

Built distribution (wheel)

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

Total release size: 147.3 kB

Release files / akshare_one-0.7.0.tar.gz

Download URL akshare_one-0.7.0.tar.gz
Size 62.0 kB
Tags Source
SHA-256 checksum
How to use checksums
8222cd99a6115fded0385e7edf656673545acd3a7ee3f66fe115bf763b0bf7dd
BLAKE2b-256 checksum
How to use checksums
cb39d1a43b28d8a576ea9f0886acb2eeb7d3fa8162baa540101dfacc36d38ab5
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 Nov 22, 2026.

Transparency log

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

Download URL akshare_one-0.7.0-py3-none-any.whl
Size 85.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a45dfb52ac2a5b0af7a867455fb3fd3ed5418e6ffc1702b9dff5cf8b8040e335
BLAKE2b-256 checksum
How to use checksums
5e13e89006ea437fffb60b1f72e6e7621d76aa4b73f6ce56064e66911364f7e2
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 Nov 22, 2026.

Transparency log

Security for akshare-one 0.7.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.7.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 Nov 22, 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.7.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