quantdb-sdk

Configure QuantDB API keys and query A-share market datasets via REST endpoints.

1.5k|337|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/qusong0627/QuantMind --skill quantdb-sdk-qusong0627
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quantdb-sdk
Source: https://github.com/qusong0627/QuantMind/tree/main/skills/quantdb-sdk
Command: npx skills add https://github.com/qusong0627/QuantMind --skill quantdb-sdk-qusong0627

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Quantitative researchers need a unified way to authenticate against the QuantDB paid data CDN, discover which of the 28 datasets (K-line, financials, valuation, L1/L2 factors) are available, preview fields, and sync data locally without guessing API endpoints or field units. ## Core Features & Use Cases - API Key Management: Check masked configuration status, save or update the QuantDB API key via admin REST endpoints, and verify key validity instantly. - Dataset Catalog & Preview: Browse 6 categories and 28 datasets (daily K-line, financial statements, valuation, technical indicators, 98 L1 factors, 216 L2 microstructure factors), preview columns and sample rows locally with zero traffic cost, or query remote K-line/tick data on demand. - Data Sync & Pipeline: Trigger asynchronous dataset sync jobs that flow QuantDB data into local Parquet, PostgreSQL snapshots, and Qlib binary caches for model training. - Use Case: A researcher wants to train a factor model and needs to know which fields exist in l1_factors. They call the preview endpoint to list all 98 factor columns, then run sync-datasets to pull the data locally before feeding it into factor mining. ## Quick Start Ask the assistant to check whether the QuantDB API key is configured and preview the first 20 rows of the valuation dataset.

Frequently Asked Questions about quantdb-sdk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a QuantDB API key?

POST your key to the /api/v1/admin/data-platform/quantdb/config endpoint with a bearer token. The key is written to config/runtime.env as QUANTDB_API_KEY and verified immediately against the QuantDB service.

How do I check which fields a QuantDB dataset contains?

Call the preview endpoint with the dataset name, for example /quantdb/preview?dataset=valuation&limit=20. The response includes a columns array listing every field name and dtype, using local Parquet files so it costs no traffic.

What datasets does QuantDB provide for A-share data?

QuantDB organizes 28 datasets into 6 groups: K-line quotes, basic instruments, financial statements, bonds and ETFs, technical derivatives like valuation and indicators, and ML factor sets including 98 L1 factors and 216 L2 high-frequency microstructure factors.

Why does my QuantDB preview return empty data?

An empty preview usually means the dataset has not been synced locally yet. Either add remote=true to query the remote SDK directly, or run sync-datasets first to pull the data into local Parquet storage.

Can I query QuantDB data without consuming traffic quota?

Yes. Local preview and catalog endpoints read from already-synced Parquet files and consume no remote traffic. Only remote SDK queries like query-kline, query-tick, and remote=true previews consume your paid quota.

What are common unit pitfalls in QuantDB datasets?

Units vary across datasets: stock volume is in shares while index volume is in lots, amount is in ten-thousand yuan, and dividend_rate is a percentage value not a decimal. Mixing these up causes errors of 1e4 to 1e6 magnitude.