AKShare One
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.comintermittently returns502(notably from outside mainland China). xueqiurealtime quotes need anxq_a_tokencookie that XueQiu no longer hands to anonymous clients, and XueQiu returns418once rate-limited.thstalks to Tonghuashun's public HTTP endpoints, which need no login. It serves one security per request, so realtime quotes need asymbol; 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 as1A0001(sh000001is mapped to it).get_options_chainreturns the option contract list with the market-data columns left empty; useget_options_realtime/get_options_histfor 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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
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.
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.