QuantDB Python SDK

QuantDB 量化数据平台官方 Python SDK，提供同步与异步两种客户端，封装了全部 API 端点。

安装

pip install quantdb-sdk

开发依赖：

pip install -e ".[dev]"

快速开始

API Key 鉴权（推荐）

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())

用户名密码鉴权

client = QuantDBClient(username="admin", password="admin123")

核心功能

数据查询：K 线、Tick 通过下载 Parquet 切片后客户端解析（消耗流量）；股票列表、交易日历、元数据走网关 JSON（不计流量）。
数据下载：Parquet 文件下载或直读 DataFrame，计入订阅流量。
本地分析：基于 DuckDB 对本地 Parquet 执行 SQL。
账户管理：查询用户信息、用量、API Key、订阅与订单。
异步客户端：基于 httpx，适用于 asyncio 量化框架。

V1 / V2 数据布局

COS 同时保留 V1（按股票历史文件）和 V2（按交易日全市场分区）。所有下载相关接口均可传入 layout="auto" | "v1" | "v2"。默认 auto 的规则是：给出 K 线日期范围时优先 V2；若任一交易日没有 V2 分区，则整次请求回退 V1，绝不混合两种口径；未给日期范围时读取 V1 全历史文件。

# 按日期范围优先 V2；覆盖不完整时自动回退 V1
df = client.query_kline("600519.SH", start_date="2026-07-01", end_date="2026-07-24")

# 强制指定物理布局；layout="v2" 缺日时会明确报错
latest = client.download_file("1", "daily_forward", trade_date="2026-07-24", layout="v2")
history = client.download_file("1", "daily_forward", symbol="600519.SH", layout="v1")

# 以发布清单为 cursor 做原子化增量同步（含 V2 patch）
result = client.sync_dataset("daily_forward", save_dir="D:/quantdb-data")

流量说明

免费注册用户获赠 100 MB 一次性体验流量；订阅用户每月含 30 GB 下载流量，超出部分按 ¥1/GB 从账户余额扣减。余额不足时下载会被拦截。

文档

完整文档请访问：https://www.quantmindai.cn/docs/sdk.html

Release files for quantdb-sdk 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for quantdb-sdk 0.2.1
File	Size	Uploaded
quantdb_sdk-0.2.1.tar.gz	29.2 kB	Jul 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for quantdb-sdk 0.2.1
File	Interpreter	ABI	Platform	Reset
quantdb_sdk-0.2.1-py3-none-any.whl 25.6 kB Jul 26, 2026	Python 3	none	any	Details

Total release size: 54.9 kB

Release files / quantdb_sdk-0.2.1.tar.gz

Download URL	quantdb_sdk-0.2.1.tar.gz
Size	29.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`9f73f3f951e1e7ce71cdca2883e54bc021f1cd508264a70bc845c0cbfd3aa477`
BLAKE2b-256 checksum How to use checksums	`0efb2997414635e3b5a34670d78f4414af65280ed75c369029bc8ae223cda688`
Upload date	Jul 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.11`

Release files / quantdb_sdk-0.2.1-py3-none-any.whl

Download URL	quantdb_sdk-0.2.1-py3-none-any.whl
Size	25.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`97422364aeb09db3d718e78d31ee41d0083ccada8d51562d2dbfcf57df70858a`
BLAKE2b-256 checksum How to use checksums	`71ee0c64e6639be2ea5b11f672ab3fe746bd0c0592a32baee3e65632673ad0e9`
Upload date	Jul 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.11`