API 文档

搜索/列出市场中的标的代码。

# 示例：搜索 A 股中包含 "600519" 的标的
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/symbols?search=600519&limit=10"

获取单标的日线 K 线数据，含 symbol/date/open/high/low/close/volume/amount/adj_factor，按日期正序（从早到晚）。symbol、date、adj_factor 始终返回，不受 fields 过滤。

adj_factor 用法：hfq_price = bfq_price × adj_factor；qfq_price = bfq_price × adj_factor / 最新日 adj_factor。用于自行做复权计算或复核。

# 示例：取贵州茅台 2025 年全年日线（前复权）
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/klines/sh600519?start=2025-01-01&end=2025-12-31&fields=c,v&adj=qfq"

# 响应示例
{
  "market": "ashare", "symbol": "sh600519",
  "count": 2, "offset": 0, "limit": 100,
  "fields": ["symbol", "date", "close", "volume"],
  "data": [
    { "symbol": "sh600519", "date": "2025-01-02", "close": 1680.50, "volume": 31245000, "adj_factor": 2.4567 },
    { "symbol": "sh600519", "date": "2025-01-03", "close": 1705.00, "volume": 28967100, "adj_factor": 2.4567 }
  ]
}

# 示例：取 BTC 永续合约近一年日线
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/crypto/klines/BTCUSDT?start=2025-01-01&end=2025-12-31"

批量获取多标的 K 线数据（按套餐限制标的数：免费 5 只、专业/企业 50 只）。每行 symbol、date、adj_factor 始终返回。

# 示例：查茅台和五粮液最近 5 个交易日收盘价+成交量
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/klines?symbols=sh600519,sz000858&limit=5&fields=c,v"

# 响应示例
{
  "market": "ashare",
  "count": 10,
  "data": {
    "sh600519": [
      { "symbol": "sh600519", "date": "2026-07-15", "close": 1845.20, "volume": 28345100, "adj_factor": 2.4567 },
      ...
    ],
    "sz000858": [
      { "symbol": "sz000858", "date": "2026-07-15", "close": 128.60, "volume": 56210300, "adj_factor": 1.1234 },
      ...
    ]
  }
}

查询单个标的的最新详细数据快照。

# 示例：取茅台最新快照（估值+规模+动量）
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/detail/sh600519?fields=pe_ratio,pb_ratio,total_market_cap,chg_20d,close_vs_52w_high"

# 响应示例
{
  "market": "ashare", "symbol": "sh600519",
  "count": 1,
  "data": {
    "symbol": "sh600519", "date": "2026-07-15",
    "pe_ratio": 21.3, "pb_ratio": 8.1,
    "total_market_cap": 19840.5, "chg_20d": 6.42,
    "close_vs_52w_high": -12.3
  }
}

批量查询多个标的的最新详细数据快照。symbols 逗号分隔，上限见套餐「批量标的数」。

# 示例：批量取茅台+五粮液最新快照
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/detail?symbols=sh600519,sz000858"

# 响应示例（按 symbol 聚合）
{
  "market": "ashare", "count": 2,
  "data": {
    "sh600519": { "symbol": "sh600519", "date": "2026-07-15", "pe_ratio": 21.3, "pb_ratio": 8.1, "total_market_cap": 19840.5 },
    "sz000858": { "symbol": "sz000858", "date": "2026-07-15", "pe_ratio": 15.8, "pb_ratio": 4.2, "total_market_cap": 4980.1 }
  }
}

基于「最新快照」按估值 / 规模 / 动量 / 活跃度筛选标的，支持排序与分页。每个市场独立查询，不做跨市场比较。

# 示例：A 股 PE 在 0~30、总市值 ≥ 1000 亿，按 20 日涨幅降序
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/screen?min_pe_ratio=0&max_pe_ratio=30&min_total_market_cap=1000&sort=chg_20d&order=desc&limit=50"

# 响应示例
{
  "market": "ashare",
  "total": 1234,
  "count": 50,
  "limit": 50,
  "offset": 0,
  "sort": "chg_20d",
  "order": "desc",
  "data": [
    { "symbol": "sh600519", "name": "贵州茅台", "date": "2026-07-15", "close": 1578.20,
      "pe_ratio": 21.3, "pb_ratio": 8.1, "total_market_cap": 19840.5,
      "chg_20d": 6.42, "close_vs_52w_high": -12.3, ... },
    ...
  ]
}

获取宏观经济数据序列：GDP / CPI&PPI / PMI。

# 示例：获取 2020-2025 年 GDP 数据
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/macro?indicator=gdp&start=2020&end=2025"

# 响应示例
{
  "count": 6,
  "data": [
    {
      "indicator": "cpi_ppi",
      "date": "2025-06-30",
      "data": {
        "CPI_CPI_YOY": 0.2,
        "CPI_CPI_MOM": -0.1,
        "PPI_PPI_YOY": -2.5,
        "CPI_CORE_YOY": 0.6,
        ...
      }
    },
    ...
  ]
}

查询当前 API Key 的套餐、日配额、今日已用量和剩余量。

# 响应示例
{
  "plan": "pro",
  "org_name": "",
  "daily_quota": 200000,
  "used": 12345,
  "remaining": 187655,
  "requests_today": 42
}