请求参数

请求示例

curl -X POST https://quantdb.quantmind.cloud/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "your_username", "password": "your_password"}'

响应示例

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer"
}

curl https://quantdb.quantmind.cloud/api/v1/auth/me \
  -H "Authorization: Bearer <jwt_token>"

{
  "username": "trader01",
  "email": "trader@example.com",
  "id": 2,
  "used_traffic": 1048576,
  "traffic_limit": 104857600,
  "credit_limit": 0,
  "purchased_traffic": 0,
  "balance_yuan": 0,
  "subscription": { "status": "free", "plan_id": "" }
}

curl https://quantdb.quantmind.cloud/api/v1/auth/usage \
  -H "Authorization: Bearer <jwt_token>"

{
  "used_traffic": 1048576,
  "traffic_limit": 104857600,
  "credit_limit": 0,
  "purchased_traffic": 0,
  "balance_yuan": 0,
  "subscription": { "status": "free", "plan_id": "" }
}

curl https://quantdb.quantmind.cloud/api/v1/auth/api-keys \
  -H "Authorization: Bearer <jwt_token>"

curl -X POST https://quantdb.quantmind.cloud/api/v1/auth/api-keys \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{"description": "量化回测脚本"}'

df = client.query_stock_list(keyword="茅台", limit=5)
print(df)

df = client.query_calendar(start_date="2026-01-01", end_date="2026-12-31")

df = client.preview_as_df("1", "daily_forward", symbol="600519.SH", limit=5)

curl -OJ "https://quantdb.quantmind.cloud/api/v1/data/download?category_id=1&sub_category=daily_forward&symbol=600519.SH" \
  -H "X-API-Key: qdb_abc..."

Python SDK

# 下载到本地
path = client.download_file("1", "daily_forward", symbol="600519.SH")

# 直接加载到 DataFrame（不落盘）
df = client.load_as_df("1", "daily_forward", symbol="600519.SH")

files = client.query_manifest("1", "daily_forward", layout="v2")
print(f"共 {len(files)} 个文件")

result = client.sync_dataset("daily_forward", save_dir="D:/quantdb-data")

• 规范对齐与稳定性增强：与 QuantDB 0.7.0 规范全面对齐，优化 ETag 缓存比对与数据传输机制

• CDN 直连重试路径修复：0.2.8 引入的重试逻辑缺失 import time / import asyncio，触发重试时抛 NameError，已补齐导入

• CDN 直连 302 相对 URL 修复：服务端 CDN 直连模式 Stage 1 返回相对 URL（/api/v1/data/cdn-bridge?token=xxx），此前直接作为请求 URL 导致 MissingSchema / UnsupportedProtocol，CDN 直连下载完全不可用；现在自动拼接 api_host 构造完整 URL
• CDN 直连请求带重试：cdn-bridge 与 CDN 签名 URL 两跳请求均带 2 次重试（指数退避 1s/2s），网络抖动不再中断整个 sync_dataset
• 302 重定向链路手动跟随：统一用重试循环跟随最多 3 跳（/download → /cdn-bridge → CDN 签名 URL），ETag 逐跳透传

• V1 回退对纯 V2 数据集失效修复：query_kline / a_query_kline 无日期范围时不再默认走 V1。margin_trading、features_daily、l1_factors、l2_factors 等 11 个纯 V2 数据集在 COS 上已无 V1 逐股票文件，V1 回退会 404。现在无范围时也走 V2 manifest 路径（全量下载所有分区），仅在有日期范围时才做日历完整性校验
• 异步客户端时区处理对齐：AsyncQuantDBClient._normalise_kline 补齐 tz_convert 逻辑，与同步客户端行为一致

• 适配服务端 CDN 直连下载（302 跳转）：修复异步客户端在 CDN 直连模式下下载/同步接口失效的问题
• 凭证保护：同步与异步客户端统一改为手动处理 302 + 无鉴权头裸请求直连 CDN，API Key 不会泄露给 CDN 域
• 302 响应中的 COS ETag 回填至 CDN 响应，保证进程内 ETag 缓存与 If-None-Match 304 逻辑一致
• [后端安全] 一次性下载令牌：302 模式改为两跳（令牌中转），防止签名 URL 被重复使用或分享
• [后端安全] 移除 ?direct=1 请求级覆盖，用户无法强制走 302 模式

• [数据架构] COS V2 数据集全面清理 V1 残留文件（~1.8 万对象），11 个 V2 数据集均为纯 V2 存储，ListObjects 分页效率提升 3-5 倍
• [数据架构] L1 日频因子（l1_factors）V2 全量上线：2565 个交易日分区（2016-01-04 ~ 至今），支持按日范围高效查询
• [数据架构] L2 高频因子（l2_factors）V2 上线：34 个交易日分区（2026-01-05 ~ 2026-02-27）