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

💻 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.1

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.1
File Size Uploaded Provenance Actions
akshare_one-0.6.1.tar.gz 57.0 kB With provenance Details for akshare_one-0.6.1.tar.gz

Built distribution (wheel)

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

Total release size: 141.8 kB

Release files / akshare_one-0.6.1.tar.gz

Download URL akshare_one-0.6.1.tar.gz
Size 57.0 kB
Tags Source
SHA-256 checksum
How to use checksums
745a5300e3e99554e9247eb3b54cb858aa686dead2ace7149c37619b4ed4d8be
BLAKE2b-256 checksum
How to use checksums
eb808117c7be6ee85f47274b8acc62623036f0ba4054f84ed12d802577bc6c32
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 21, 2026.

Transparency log

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

Download URL akshare_one-0.6.1-py3-none-any.whl
Size 84.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12a86e710c2d440fd74766fb2c028326c8a04b7176c5da3130b11aa92dccf867
BLAKE2b-256 checksum
How to use checksums
dc01a6ce0dd54641176acd32b8ac26ebc46443fe50a98b23de100418fab53131
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 21, 2026.

Transparency log

Security for akshare-one 0.6.1

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.1.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 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.1 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