Metadata-Version: 2.4
Name: akshare-one
Version: 0.2.3
Summary: Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs
License-Expression: MIT
Project-URL: Homepage, https://github.com/zwldarren/akshare-one
Project-URL: Repository, https://github.com/zwldarren/akshare-one.git
Keywords: akshare,financial-data,stock-data,quant
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: akshare>=1.17.5
Requires-Dist: cachetools>=6.1.0
Dynamic: license-file

<div align="center">
  <h1>AKShare One</h1>
  <div>
    <a href="README_zh.md">中文</a> | <strong>English</strong>
  </div>
</div>

**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/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` |
| Internal transactions | `get_inner_trade_data` |

## 📦 Quick Installation

```bash
pip install akshare-one
```

## 💻 Usage Example

```python
from akshare_one import get_hist_data, get_realtime_data

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

# Get real-time data
df_realtime = get_realtime_data(symbol="600000")
```

## 📚 Documentation

Detailed API reference: [docs/api.md](docs/api.md)
