| name | quantdb-fields |
| description | QuantDB 字段单位速查手册 — 全部数据集实测验证的单位、口径与陷阱（个股 volume=股/amount=万元、指数 volume=手、technical % vs l1 小数、dividend_rate 百分数、PG 前缀 symbol）。用 QuantDB 数据做分析/回测/报告、判断成交量/成交额/股息率/换手率单位、排查数据口径不一致时使用。触发词：字段单位、成交量单位、成交额单位、股还是手、万元、股息率、数据口径 |
quantdb-fields — QuantDB 字段单位速查手册
用 QuantDB 数据做任何分析/回测/报告前必读。所有单位均为
2026-08 直接读本地 parquet 实测验证（不是照抄文档）。
单位搞错的后果：成交额差 1 万倍、股息率差 100 倍、换手率差 100 倍——
分析结论全部作废。
一、通用规则（先记这个）
| 规则 | 说明 |
|---|
| 个股成交量 = 股 | A 股 1 手 = 100 股，但 QuantDB 个股 kline 的 volume 单位就是股，不是手 |
| 个股成交额 = 万元 | amount = 5828.37 表示 5828.37 万元（约 5828 万），不是元 |
| 指数成交量 = 手 | index_daily.volume 单位是手（1 手 = 100 股），与个股相反！ |
| 市值 = 元 | valuation 的 total_mv/float_mv 单位是元（工业富联 float_mv ≈ 1.31 万亿） |
| 比例字段 ≈ 小数或 % | 没有统一约定，按数据集查下表；% 的字段值 = 百分数（4.06 即 4.06%） |
| symbol 格式按数据源分 | parquet 用后缀 601138.SH；PG 的 stock_daily_latest 用前缀 SH601138 |
| 验证公式 | 个股 close*volume/amount ≈ 1e4（股+万元）；指数 ≈ 2e4（手+万元） |
二、1_kline_data 日线（daily_forward / daily_backward / daily_unadjusted）
| 字段 | 单位 | 实测依据 |
|---|
volume | 股 | 601138 20260814 volume=4704920 股，amount=5828.37 万元，close*volume/amount≈1e4 |
amount | 万元 | 同上（close 66.19 × 470 万股 ≈ 3.1 亿 ≈ 31163 万元，与 amount 同量级吻合） |
open/high/low/close | 元（forward=前复权，backward=后复权，unadjusted=不复权） | |
| 单位切换传闻 | 不存在。20260721 前后 amount 均为万元、volume 均为股。曾有记忆说 20260721 切换到"手/元"，实测已无此切换，按股/万元统一处理 | |
min1/min5：同单位（volume=股、amount=万元），但数据停滞在 2026-07-24，用前先查最新日期。
三、1_kline_data/index_daily 指数日线（⚠️ 与个股相反）
| 字段 | 单位 | 实测依据 |
|---|
volume | 手（×100=股） | 上证 000001.SH 20260814 volume=499525600 手 = 499.5 亿股（合理）；close*volume/amount=19808≈2e4 |
amount | 万元 | 99037192 万元 = 9903.7 亿元 ≈ 上证单日成交额 ✓ |
close | 点位 | 3927.18 |
反推：指数平均股价 = close×100/(close×volume/amount) = close×100/19808 ≈ 19.8 元/股，符合 A 股平均股价，故 volume 必为手。
四、5_technical_derived 技术衍生
valuation（估值）
| 字段 | 单位 | 注意 |
|---|
close | 元，不复权 | 601138 close=66.19（与 technical_indicators 的后复权 close=70.05 不同） |
total_mv / float_mv | 元 | float_mv=1313480468277.96 ≈ 1.31 万亿 ✓ |
total_capital / circulating_capital | 股 | 19844092284 股 ≈ 198.4 亿股 |
net_profit_ttm / revenue_ttm / equity / annual_net_profit | 元 | |
pe_ttm / pe_static / pb / ps_ttm | 倍 | |
dividend_rate | %（百分数值） | 0.148 = 0.148%！公式 = 近一年每10股派息/10/close×100。601138: 0.98/10/66.19×100=0.1481 ✓；600519: 51.98/10/1341.99×100=0.3873 ✓。把它当小数会差 100 倍 |
dividend_rate 口径切换 | 20260814 起 | 此前为小数口径（每10股派息/不复权close，如 0.98/65.60=0.01494）；20260814 起切换为百分数口径（×100）。同字段历史不连续，跨 20260814 分析需 ×10 归一 |
technical_indicators（技术指标）
| 字段 | 单位 | 陷阱 |
|---|
close | 后复权 | 601138=70.05，与不复权 66.19 不同；凡基于 close 算的指标都是后复权口径 |
volume_ma_3/5 | 股 | |
amount_ma_5 | 万元 | |
pct_change | % | 1.4717 = 1.47% |
return_1d / return_20d | 缺失（NaN） | 别用，改用 pct_change |
vol_std_20 | % | 4.0578 = 4.06%（l1 里同名字段是小数 0.0406，差 100 倍！） |
vol_atr_14 | 元 | 3.58 元（l1 同名字段也是元，一致） |
macd_hist / rsi_14 / kdj_* | 原始指标值 | 与 l1 一致 |
market_sentiment（市场情绪）
| 字段 | 单位 |
|---|
close | 不复权 |
turnover_rate 等比率 | 小数（0.02 = 2%） |
momentum_* | %（百分数值） |
五、6_ml_datasets 因子
features_daily（技术+估值合并表）
| 字段 | 单位 | 注意 |
|---|
dividend_rate | 小数口径（无 ×100） | 与 valuation 不同！公式 = 每10股派息/不复权close（0.98/66.19=0.0148），从未切换口径。valuation 20260814 起是它的 10 倍。特征快照 generate_feature_snapshots.py 已 ×10 归一到百分数口径 |
total_mv / float_mv / pe / pb 等 | 与 valuation 完全一致 | 实测 601138 全部 ✓ |
l1_factors（一级因子，decimal 为主）
| 字段 | 单位 |
|---|
收益率类 mom_ret_* | 小数（0.0147 = 1.47%） |
vol_std_* | 小数（0.0406 = 4.06%；与 technical_indicators 的 % 版本差 100 倍） |
vol_atr_14 | 元（3.55 元） |
fun_total_mv | ln(市值元) —— 用时要 exp() |
| 分位数/percentile 字段 | 0~1 小数 |
liq_* / fun_turnover / fun_mv | 部分日期为 None，注意补缺 |
l2_factors（二级因子，flow 金额注意）
| 字段 | 单位 | 实测依据 |
|---|
flow_net_amount / flow_super_net / flow_large_net / flow_medium_net / flow_small_net | 元 | 600519 flow_net_amount=-274109797.7 元 = -2.74 亿；flow_net_amount/(amount×1e4)=flow_net_ratio ✓ |
flow_*_ratio | 小数 | |
vol_turnover_total | 股 | 与 kline volume 完全相等 ✓ |
| 分区 | 已恢复日更（2026-08-19 实测至 20260818，flow_net 5098 distinct 有区分度） | ⚠️ 此前「停更 2026-02-27」结论过时；top 少数几只净流入会厂商同值（如 165564181），属口径非 bug |
六、PG 表 stock_daily_latest（API 服务数据源）
| 列 | 单位 / 格式 | 实测依据 |
|---|
symbol | 前缀格式 SH601138（不是 601138.SH） | suffix 查询 0 行，prefix 查询 1072 万行 |
volume | 股 | 601138 max_volume=633217088 股 |
amount | 万元 | 601138 amount=5828.37，max_amount=3306339（万元） |
float_mv / total_mv | 元 | float_mv=7095151630 元 |
turnover_rate / flow_net_amount / main_flow | NULL（未灌） | 风险评分里"缺少换手率"由此而来 |
volume_ratio_5 | 倍（0.934） | |
flow 灌入口径（update_sdl_complete_pipeline.py）：main_flow = flow_large_net_amount/1e6（百万元），flow_net_amount = flow_net_amount/1e6（百万元）——与 l2 parquet 的元不同，读 PG 时注意。
七、research API 换算表（/research/features 等接口返回）
API 层 _UNIT_SCALES 把部分字段缩放后输出：
| 输出字段 | 缩放 | 输出单位 | 例（600519 探针） |
|---|
totalMv / floatMv | ×1e-8 | 亿元 | 16775.97 亿 ✓ |
mainFlow / flowNetAmount / flowLargeNet / flowMediumNet / flowSmallNet | ×1e-6 | 百万元 | flow_net_amount=-274.11（百万） |
flowSuperNet | 无缩放 | 元（bug！） | flow_super_net=-6840376 元，与同类别其他字段差 1e6 |
turnoverRate | — | % 小数 | 0.00239 |
⚠️ fundFlow 类别内单位不一致：flowSuperNet 是元，其余 flow* 是百万元。skill 分析时要统一换算后再比。
八、3_financial_data 财务数据
| 数据集 | 字段 | 单位 |
|---|
balance / income / cashflow | 各科目 | 元 |
capital | 股本 | 股 |
holder_num | 股东户数 | 户 |
dividend_factors | interest | 每10股派息（元）——600519 每10股派 51.98 元，601138 派 0.98 元。算每股股息要 /10 |
dividend_factors | stockBonus / stockGift / allotNum | 每10股送/转/配股数 |
dividend_factors | dr | 除权因子（复权用） |
九、2_base_sector
| 数据集 | 字段 | 单位 | 注意 |
|---|
instrument_detail | Symbol | 后缀 601138.SH | HqDate 停滞 20260720，市值/估值滞后 |
| J_zgb / FreeLtgb | 万股（1984409.25 万股 = 198.4 亿股） | 与 valuation 的 circulating_capital(股) 差 1e4 |
| J_yysy / J_jly / J_zzc 等 J_* | 万元（25107808 万 = 251 亿） | 与 financials 的元差 1e4 |
| Zsz / Ltsz | 亿元（11211.91 亿 ✓） | |
| J_mgsy | 元（2.14 元/股） | |
| fHSL | 不明（0.56，非换手率%，与自算 0.74% 不符），别当换手率用 | |
| TotalBVol | 不明（43555，量级像手，但远小于全天量） | L2 快照字段，非全天 |
| DYRatio | 不可靠（600519=4.15 vs 真实 0.39%），别当股息率，用 valuation.dividend_rate | |
| Yield | 不明（6078.44），勿用 | |
index_weights | Weight | % | 文件名 000300.SH.parquet 不是 000300.parquet |
trading_calendar | TradingDate | YYYYMMDD int | |
十、其他数据集
| 数据集 | 字段 | 单位 | 状态 |
|---|
margin_trading | finance_* | 万元 | |
| slo_volume / slo_net | 股 | |
hsgt_north | holding_quantity 股 / holding_value 元 / 比率 % | | 停滞 2024-08（北向改季度披露后） |
十一、已知数据缺口（2026-08 实测）
- min1/min5 分钟线停更（最新 2026-07-24）
l2_factors 分区停更 —— 已恢复（2026-08-19 实测至 20260818）- hsgt_north 北向明细停更（2024-08，改季度披露所致）
- instrument_detail HqDate 滞后（20260720）
- dt=20260729~20260802 个股日线有同步缺口（非交易日+同步中断）
5b. valuation dt=20260813 只有 101 行（同步缺口，dividend_rate 全 NaN），features_daily 同日 5543 行正常
- technical_indicators.return_1d/return_20d 全 NaN
- stock_daily_latest 的 turnover_rate/flow_net_amount/main_flow 常为 NULL
十二、分析前检查清单
