Metadata-Version: 2.4
Name: ardata-sdk
Version: 1.0.0
Summary: ARData Python SDK - A-share market data client
Author-email: ARQuant <otreewen2020@users.noreply.github.com>
License-Expression: MIT
Keywords: a-share,stock,quant,china-market
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Requires-Dist: pandas>=1.5
Dynamic: requires-python

# ARData SDK

Python SDK for ARQuant market data platform.

## Install

```bash
pip install ardata-sdk
```

## Quick Start

```python
import ardata_sdk as ardata

# Initialize with your API key and server URL
ardata.init(token="your-api-key", base_url="https://ardata.example.com")

# Get daily price data
df = ardata.get_price(["000001.XSHE", "600519.XSHG"],
                       start_date="2024-01-01",
                       end_date="2024-12-31",
                       frequency="daily",
                       fields=["open", "close", "high", "low", "volume"],
                       fq="pre")

# Get all A-share securities
securities = ardata.get_all_securities()

# Get trade days
trade_days = ardata.get_trade_days(start_date="2024-01-01", end_date="2024-12-31")

# Get industry info
industries = ardata.get_industry(["000001.XSHE"])
```

## API Reference

| Function | Description |
|----------|-------------|
| `get_price()` | Historical OHLCV data |
| `get_all_securities()` | List all securities |
| `get_security_info()` | Security details |
| `get_trade_days()` | Trading calendar |
| `get_industry()` | Industry classification |
| `get_index_stocks()` | Index constituents |
| `get_fundamentals()` | Financial data (valuation, balance sheet, etc.) |
| `get_money_flow()` | Capital flow data |
| `get_billboard_list()` | Dragon-tiger board data |
| `get_factor_values()` | Alpha factors |
| `history()` / `attribute_history()` | JQData-compatible history APIs |
| `get_ticks()` | Tick-level data |
| `finance.run_query()` | Financial table query DSL |
