Metadata-Version: 2.4
Name: cyberquant
Version: 1.0.2
Summary: 数据共享API服务平台命令行工具
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28.0
Requires-Dist: rich>=13.9.0
Requires-Dist: typer>=0.15.0
Description-Content-Type: text/markdown

# cyberquant

数据共享 API 服务平台的命令行工具。

## 安装

```bash
# 推荐使用 pipx（隔离环境）
pipx install cyberquant

# 或使用 pip
pip install cyberquant
```

## 快速开始

1. **首次配置**
   ```bash
   cyberquant config set
   ```
   交互式输入 API 端点地址和 API Key。

2. **查询数据**
   ```bash
   cyberquant query --tradeDate 2026-06-01 --stockCode 920992 --pageSize 10
   ```

## 主要命令

### config — 配置管理
```bash
cyberquant config set      # 设置端点和 API Key
cyberquant config list     # 查看当前配置
cyberquant config status   # 查询账户状态
```

### query — 数据查询
```bash
# JSON 输出
cyberquant query a-daily-bfq --tradeDate 2026-06-01 --stockCode 920992 --pageSize 10

# JSON 输出文件，日期支持范围查询（同一参数多次传递）
cyberquant query a-rt-min --tradeTime 2026-05-20 --tradeTime 2026-05-21 --stockCode sz301125 --period 5 --output ~/Downloads/rt-min-query.json

# CSV 格式输出到文件, --all(自动翻页)
cyberquant query a-rt-min --tradeTime 2026-05-20 --tradeTime 2026-05-21 --stockCode sz301125 --period 5 --all --format csv --output ~/Downloads/rt-min-query.csv

```

### stream — 实时流
```bash
# 实时行情（JSON 输出）
cyberquant stream a-rt-min --tradeTime 2026-05-20 --tradeTime 2026-05-21 --stockCode sz301125 --period 5

# 输出到 CSV 文件，日期支持范围查询（同一参数多次传递）
cyberquant stream a-rt-min --tradeTime 2026-05-20 --tradeTime 2026-05-21 --stockCode sz301125 --period 5 --format csv --output ~/Downloads/rt-min-stream.csv
```

## 技术要求

- Python >= 3.10
- 依赖：Typer、Rich、httpx

## 许可证

[待添加]
