API 文档A 股实时行情 · WebSocket 实时推送 + REST 快照/历史查询。一次接入，覆盖快照、五档盘口、1m/5m K 线与日 K（前复权）。

查询今天是否为 A 股交易日。

curl "https://api.datapush.vip/api/v1/trading/today" \
  -H "Authorization: Bearer sk-xxx"

// 返回
{ "code": 0, "message": "ok", "data": {
  "date": "2026-09-07", "trading": true } }

返回可用的板块/指数列表，如上证指数、深证成指、沪深300 等。

curl "https://api.datapush.vip/api/v1/market/boards" \
  -H "Authorization: Bearer sk-xxx"

// 返回
{ "code": 0, "message": "ok", "data": [
  { "code": "sh.000300", "name": "沪深300" },
  { "code": "sh.999999", "name": "上证指数" },
  { "code": "sz.399001", "name": "深证成指" },
  { "code": "sz.399005", "name": "中小板指" },
  { "code": "sz.399006", "name": "创业板指" }
] }

分页查询股票基础信息（轻量字段）。

curl "https://api.datapush.vip/api/v1/stocks?page=1&page_size=20" \
  -H "Authorization: Bearer sk-xxx"

// 返回（data 为数组，元素为轻量字段）
{ "code": 0, "message": "ok", "data": [
  { "code": "000001", "name": "平安银行", "market": "sz", "price": 11.52,
    "roe": 8.5, "zgb": 194.1, "ltgb": 194.1, "ltsz": 2233.9, "zsz": 2233.9,
    "ipo_date": "1991-04-03" }
] }

查询单只股票的基础信息（含总股本、流通股本、市值、ROE 等字段，复权数据不返回）。

curl "https://api.datapush.vip/api/v1/stocks/sz.000001" \
  -H "Authorization: Bearer sk-xxx"

// 返回（data 为完整基础信息，复权数据不返回）
{ "code": 0, "message": "ok", "data": {
  "code": "000001", "name": "平安银行", "market": "sz", "price": 11.52,  "industry": "白酒",
  "region": "贵州板块", "roe": 8.5, "zgb": 194.1, "ltgb": 194.1, "ltsz": 2233.9, "zsz": 2233.9,
  "ipo_date": "1991-04-03" } }

返回 1 分钟前复权（默认） K 线，最新时间在前，所有参数选填（offset，size 或者 since 模式二选一）。通常 A 股每个交易日 240 根 K 线。

curl "https://api.datapush.vip/api/v1/stocks/000001/minute?offset=0&size=10" \
  -H "Authorization: Bearer sk-xxx"

// 返回（data 为对象；count 为根数，kline 为 8 字段数组、最新在前，last_time/latest_time 为本批最老/最新一根）
{ "code": 0, "message": "ok", "data": {
  "code": "sz.000001", "type": "minute", "count": 240,
  "kline": [[开, 收, 高, 低, 量, 额, 换手率, "YYYY-MM-DD HH:MM"], ...],
  "last_time": "YYYY-MM-DD HH:MM", "latest_time": "YYYY-MM-DD HH:MM"
} }

返回 5 分钟前复权（默认） K 线，最新时间在前，所有参数选填（offset，size 或者 since 模式二选一）。通常 A 股每个交易日 48 根 K 线。

curl "https://api.datapush.vip/api/v1/stocks/000001/fiveminute?offset=0&size=30" \
  -H "Authorization: Bearer sk-xxx"

// 返回（data 为对象；count 为根数，kline 为 8 字段数组、最新在前，last_time/latest_time 为本批最老/最新一根）
{ "code": 0, "message": "ok", "data": {
  "code": "sz.000001", "type": "fiveminute", "count": 48,
  "kline": [[开, 收, 高, 低, 量, 额, 换手率, "YYYY-MM-DD HH:MM"], ...],
  "last_time": "YYYY-MM-DD HH:MM", "latest_time": "YYYY-MM-DD HH:MM"
} }

查询日 K 历史前复权(默认)，所有参数选填（offset，size 或者 since 模式二选一）。返回 kline 为按时间倒序的 8 字段数组，见K 线字段。

curl "https://api.datapush.vip/api/v1/stocks/000001/kline?offset=0&size=100" \
  -H "Authorization: Bearer sk-xxx"

// 返回（data 为对象；count 为根数，kline 为 8 字段数组、最新在前，last_time/latest_time 为本批最老/最新一根）
{ "code": 0, "message": "ok", "data": {
  "code": "sz.000001", "type": "day", "count": 100,
  "kline": [[复权开, 复权收, 复权高, 复权低, 量, 复权额, 换手率, "YYYY-MM-DD 15:00"], ...],
  "last_time": "YYYY-MM-DD 15:00", "latest_time": "YYYY-MM-DD 15:00"
} }

返回按日期区间压缩的复权因子表（segments），用于本地计算前复权与后复权。 典型用法：用 adj=none 拉不复权原始价（原始价历史永不改写，适合本地缓存与增量追加）， 再用本表一次乘法派生复权序列 —— 除权后无需重下历史。

curl "https://api.datapush.vip/api/v1/stocks/000001/xdxr" -H "Authorization: Bearer sk-xxx"

{ "code": 0, "message": "ok", "data": {
  "code": "sz.000001",
  "latest_event_date": "2026-09-25",   // 与上次不同 ⇒ 重拉本表并本地重算
  "count": 4,                           // = segments 长度（可自检表是否完整）
  "ltgb": 1234000000,                   // 流通股本（股）—— 算换手率的分母
  "segments": [                         // 按 from 降序
    { "from": "2026-09-25", "qfq": 1.0,    "hfq": 1.5,  "share_ratio": 1.0   },
    { "from": "2024-06-14", "qfq": 1.0,    "hfq": 1.5,  "share_ratio": 1.2   },
    { "from": "2010-01-01", "qfq": 0.8333, "hfq": 1.25, "share_ratio": 1.44  },
    { "from": "",           "qfq": 0.6667, "hfq": 1.0,  "share_ratio": 1.728 }
  ]
} }

怎么算：本地前复权 / 后复权

① 用 adj=none 取原始价 bar：“[open, close, high, low, cjl, cje, hsl, "YYYY-MM-DD HH:MM"]” （价格与成交额都是原始值）。② 取本接口的 segments。③ 每根 bar 选一段： 按 from 降序取第一个 from ≤ bar.date 的段；都不满足（或该段 from 为空）⇒ 用 兜底段。 ④ 一次乘法：

前复权价 = raw价 × seg.qfq        // 基准 = 当日；除权后全部历史被改写
后复权价 = raw价 × seg.hfq        // 基准 = 该标的最早；除权后历史不变、只影响事件日之后
换手率   = cjl / ltgb × seg.share_ratio × 100      // 与价格口径无关
成交额   = raw.cje                          // **成交量与成交额都不复权**（金额是历史事实，不随因子缩放）

自检（建议写进 SDK 断言）：seg.hfq × P == seg.qfq，其中 P = 兜底段.qfq （兜底段覆盖全部事件 ⇒ 它的 qfq 就是全体事件因子连乘）。逐段成立即说明表自洽、未被截断。

def pick_segment(segments, date):        # segments 按 from 降序
    for s in segments:
        if s["from"] and s["from"] <= date:
            return s
    return segments[-1]                  # from 为空的兜底段

def adjust_bar(bar, segments, ltgb):
    seg = pick_segment(segments, bar[7][:10])
    raw = bar[:7]
    qfq = [raw[0]*seg["qfq"], raw[1]*seg["qfq"], raw[2]*seg["qfq"], raw[3]*seg["qfq"],
           raw[4], raw[5]]                       # 量、额不缩放
    hfq = [raw[0]*seg["hfq"], raw[1]*seg["hfq"], raw[2]*seg["hfq"], raw[3]*seg["hfq"],
           raw[4], raw[5]*seg["hfq"]]
    hsl = raw[4] / ltgb * seg["share_ratio"] * 100
    return qfq, hfq, hsl

增量更新流程（推荐）

1) 本地只存 adj=none 原始价（永不改写）⇒ 用 since 增量拉取、直接追加
2) 记录 xdxr.latest_event_date；与本地不同 ⇒ 重拉因子表
3) 除权后本地重算：
     后复权：只有「事件日之后」的 bar 受影响（历史不变，只需算新增区间）
     前复权：全部历史受影响（本地重乘一遍，或直接重拉服务端 adj=qfq）
4) 全程无需重下历史数据

返回全部因子字段的元数据（字段名 / 中文名 / 单位 / 行内下标）。字段以响应内容为准。

curl "https://api.datapush.vip/api/v1/factors" -H "Authorization: Bearer sk-xxx"

// 返回：count = 69 = date + 日K 7 + 因子 61（存量 15 + 实时计算 46）；实际列数以响应为准
{ "code": 0, "message": "ok", "data": {
  "count": 69,
  "fields_order": ["date","open","close","high","low","cjl","cje","hsl","vol_pct_pre_high", ... ,"coef_adj_line"],
  "factors": [
    { "key": "open", "name": "开盘价", "unit": "元", "order": 0 },
    { "key": "ener_raw", "name": "原始量能累计", "unit": "%", "order": 9 },
    { "key": "pot_x_turn", "name": "势能原始值", "unit": "%", "order": 26 }
  ]
} }

一次拿全「日K + 因子」：日K列（前复权，与日K线接口同序：open, close, high, low, cjl, cje, hsl）＋ 因子列。只要部分因子时用 fields 指定因子列（日K列默认仍会带上；daily_kline=0 可关掉）。

curl "https://api.datapush.vip/api/v1/stocks/600108/factors?size=30" \
  -H "Authorization: Bearer sk-xxx"

// 返回：rows 的元素顺序见 fields_order；缺值一律 null
{ "code": 0, "message": "ok", "data": {
  "code": "sz.000001", "name":"平安银行", "type": "factor",
  "count": 30, "latest_time": "2026-09-15 15:00:00",
  "fields_order": ["date","open","close","high","low","cjl","cje","hsl","vol_pct_pre_high", ...],
  "rows": [ ["2026-09-15", 12.34, 12.55, 12.60, 12.20, 1234567, 15234567.0, 1.23, 0.41, ...], ... ]
} }

实时行情通过 WebSocket 推送。API Key 三种传递方式（按优先级）：