quantdb-sdk 0.1.0__py3-none-any.whl

quantdb_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: quantdb-sdk
+Version: 0.1.0
+Summary: QuantDB 量化数据平台官方 Python SDK
+Author: QuantDB Team
+License: MIT
+Project-URL: Homepage, https://www.quantmindai.cn
+Project-URL: Documentation, https://www.quantmindai.cn/docs/sdk.html
+Project-URL: Repository, https://github.com/quantdb/quantdb
+Keywords: quant,finance,data,a-share,parquet
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: duckdb>=0.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: responses>=0.23.0; extra == "dev"
+Requires-Dist: respx>=0.20.0; extra == "dev"
+
+# QuantDB Python SDK
+
+QuantDB 量化数据平台官方 Python SDK，提供同步与异步两种客户端，封装了全部 API 端点。
+
+## 安装
+
+```bash
+pip install quantdb-sdk
+```
+
+开发依赖：
+
+```bash
+pip install -e ".[dev]"
+```
+
+## 快速开始
+
+### API Key 鉴权（推荐）
+
+```python
+from quantdb_sdk import QuantDBClient
+
+client = QuantDBClient(api_key="qdb_xxx...")
+
+# 查询用量
+usage = client.get_usage()
+print(f"已用: {usage['used_gb']:.2f} GB, 剩余: {usage['remaining_gb']:.2f} GB")
+
+# K 线查询（免费）
+df = client.query_kline(
+    "600519.SH",
+    adj_type="forward",
+    start_date="2026-01-01",
+    end_date="2026-07-22",
+)
+print(df.head())
+```
+
+### 用户名密码鉴权
+
+```python
+client = QuantDBClient(username="admin", password="admin123")
+```
+
+## 核心功能
+
+- **数据查询**：K 线、Tick 通过下载 Parquet 切片后客户端解析（消耗流量）；股票列表、交易日历、元数据走网关 JSON（不计流量）。
+- **数据下载**：Parquet 文件下载或直读 DataFrame，计入订阅流量。
+- **本地分析**：基于 DuckDB 对本地 Parquet 执行 SQL。
+- **账户管理**：查询用户信息、用量、API Key、订阅与订单。
+- **异步客户端**：基于 httpx，适用于 asyncio 量化框架。
+
+## 流量说明
+
+每月前 30 GB 下载流量免费，超出部分按 ¥1/GB 计费；账户余额不足时，下载会被限流，充值后即可恢复。
+
+## 文档
+
+完整文档请访问：https://www.quantmindai.cn/docs/sdk.html

quantdb_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+quantdb_sdk/__init__.py,sha256=7Eo9DPsThv9s4mx1AfX17dl59nAEPGGwslFHL768oGY,789
+quantdb_sdk/__main__.py,sha256=5dWkwW_zhUrKMO_aTtYJC8xUfctdMKVsT6jyzpd-LVY,2274
+quantdb_sdk/_utils.py,sha256=52gmz6UMEHbf66PMPjTN_lewOXaHShB71nT-Vqknzws,1764
+quantdb_sdk/async_client.py,sha256=JeyHVz_e0qmK5bUDodZ87TM10f7uomrecVPJHjHbP9c,17987
+quantdb_sdk/client.py,sha256=qfrGrIrwX1_UgLEqfia7q_laFbhyRkxK9YWttbmhrTw,24059
+quantdb_sdk/errors.py,sha256=6oDirsuyOBvSfyJRmLijhK3iT4n9SCbUKWZUbPCqLvk,691
+quantdb_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+quantdb_sdk-0.1.0.dist-info/METADATA,sha256=MPrUoz281ThnLfs8Qu1s4Z9YK3caioayq8bFNxR00Vg,2929
+quantdb_sdk-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+quantdb_sdk-0.1.0.dist-info/top_level.txt,sha256=_cE7xa3_JBdTL-IDKD6rqV02Mq2_F8YRZchNc6BiGBA,12
+quantdb_sdk-0.1.0.dist-info/RECORD,,

quantdb_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

quantdb_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+quantdb_sdk