数据字典
rentgpu.link 全部对外数据文件的字段定义。字段新增或语义变更会同时记入变更日志。
版本 2026-11-01
许可 CC BY 4.0
编制：GPU 算力雷达（已获 Chainfir Capital（链杉资本）投资）
读法：「是否计入指数」一列是重点。标 否 的字段或取值不参与 GHPI 计算，只作参考。比价排序与指数计算使用同一套过滤规则。
1. 通用过滤规则（先看这个）
一条报价要进入指数或最低价排名，必须同时满足：
| 条件 | 要求 | 说明 |
|---|
| price_type | ondemand | 仅按量计费。竞价（spot）与包月折算（reserve）不参与 |
| stock | available | 仅在架。缺货不参与，且不会被链式法固化为涨价 |
| data_status | 非 stale / suspect | 过期（采集失败）与异常波动会被剔除 |
| src | 非 seed | seed = 无公开价目页时的人工登记参考价，不参与指数与最低价排名 |
| price_hour_cny | > 0 | 价格为 0 或缺失视为无效 |
2. ghpi.json — 指数主文件
顶层字段
| 字段 | 类型 | 定义 |
|---|
| name / cn / en | string | 指数名称：GHPI / GPU 按小时价格指数 / GPU Hourly Price Index |
| version | string | 数据版本号，随口径变更递增 |
| unit | string | CNY / 卡·小时 |
| license | string | CC BY 4.0，署名即可使用 |
| attribution | string | 要求的署名文字 |
| publisher | string | 编制方 |
| generated_at | ISO8601 | 本次生成时间 |
| issue | string | 期号，形如 GHPI-2026-11 |
| latest | object | 三条序列的最新值，见下 |
| methodology | object | 方法论全文（样本 / 过滤 / 归一 / 货币 / 观测单元 / 指数方法 / 篮子 / 重定基期 / 免责） |
| series | object | 三条序列的完整点位 |
| daily | object | 逐日快照：{日期: {h100, cn, domestic, index, top}} |
| quality | object | 数据质量，含排除明细 |
| counts | object | 快照天数 / 卡型数 / 平台数 / 中国平台数 |
latest[序列] 字段
| 字段 | 类型 | 计入指数 | 定义 |
|---|
| name | string | — | 序列名 |
| price | number | 是 | 篮子价：基期锁定的固定篮子中、当日仍在架报价对的价格中位数。与指数同口径 —— 不会因新进一个便宜报价对而跳变 |
| market_min | number | 否 | 当日全样本最低在架价。会随覆盖扩面而下降，不代表市场降价，不可与指数混用 |
| index | number | 是 | 链式匹配指数，基期 = 100 |
| date | string | — | 本值对应日期 |
| dod_pct | number | — | 日环比（%） |
| vs_base_pct | number | — | 相对基期变动（百分点） |
| offers | int | — | 当日在架报价条数 |
| base_date | string | — | 基期日期 |
| base_price | number | — | 基期篮子价（与 price 同口径，可直接比较） |
| base_pairs | int | — | 基期报价对数量。用于判断可信度，样本越小越需谨慎 |
| matched_pairs | int | — | 与上一日的交集报价对数量 |
| basket_size | int | — | 固定篮子的报价对总数（锁定于基期） |
| basket_live | int | — | 篮子中当日仍在架的报价对数量 |
| iqr | number|null | — | 篮子内价格的四分位距，衡量离散度。样本 <4 时为 null |
| chained | bool | — | 本日环比是否真实计算。false = 因交集不足而顺延，指数沿用前值 |
| basket_method | string | — | 篮子口径说明 |
2026-11-01 口径变更（重要）：在此之前，price 取的是「当日全样本最低价」。实测发现该口径会被单个新进便宜报价对直接拉垮 —— GHPI-H100 在 2026-10-20 因样本由 5 对扩到 7 对，该值由 ¥18.00 变为 ¥8.28，而同日篮子中位数仅由 ¥23.04 变为 ¥22.50，指数亦正确保持 100.0，三者并列展示会自相矛盾。现已改为固定篮子中位数，原「最低价」语义由 market_min 承载。
series[序列].points[ ] 点位字段
| 字段 | 定义 |
|---|
| d | 日期 |
| v | 篮子价（固定篮子中位数） |
| m | 当日全样本最低在架价 |
| i | 链式指数 |
| n | 当日在架报价对数 |
| bn | 篮子中在架的报价对数 |
| iqr | 篮子价格四分位距 |
| chained | 本日环比是否真实计算 |
quality 字段
| 字段 | 定义 |
|---|
| offers_total / offers_usable / offers_excluded | 报价总条数 / 可用条数 / 被排除条数 |
| coverage_pct | 可用率 = usable ÷ total |
| excluded_breakdown | 排除明细：stale（过期）/ suspect（异常波动）/ seed（人工登记参考价）/ not_ondemand_or_unavailable |
| platforms_total / platforms_live | 收录平台数 / 本轮有实时价的平台数 |
| refresh_minutes | 采集间隔（分钟） |
3. prices.json — 报价明细
| 字段 | 计入指数 | 定义 |
|---|
| platform | — | 平台 ID，对应 platforms.json 的 id |
| gpu_model | — | 卡型全称含显存，如 RTX 4090、A100 80GB。同名不同显存视为两个卡型（用于区分魔改卡） |
| price_hour_cny | 是 | 单卡每小时价格（CNY）。整机价已按卡数归一 |
| price_type | 是 | ondemand / spot / reserve |
| stock | 是 | available 在架 / 其它 |
| src | 是 | api 接口 / page 定价页 / seed 人工登记参考价 |
| data_status | 是 | ok / stale / suspect |
| fetched_at | — | 采集时间（ISO8601 含时区），用于判断新鲜度 |
| billing_notes | 否 | 计费口径备注（是否含 CPU / 存储 / 网络、最低计费时长等） |
4. market.json — 30 天行情聚合
| 字段 | 定义 |
|---|
| generated_at | 生成时间 |
| window_days / days_covered | 窗口天数 / 实际覆盖天数 |
| date_from / date_to | 窗口起止日期 |
| gpus[卡型].series[ ] | 逐日序列，每项含 d 日期、p 最低价、plat 平台、stock 库存、med 中位数、n 样本数 |
| platforms[平台] | 平台维度统计：days_seen 出现天数、days_live 有实时价天数、presence_pct、live_pct、cards 卡型数、last_seen 最后出现、score / grade 覆盖评级 |
5. platforms.json — 平台名录
| 字段 | 定义 |
|---|
| id / name | 平台内部 ID / 展示名 |
| region | 地域归属：中国 / 北美 / 欧洲 / 亚太 |
| url | 平台官网 |
| affiliate_url | 带佣金的推广链接。存在此字段即代表该平台有佣金关系 |
| cash_commission / commission_desc / commission_detail | 佣金比例与说明 |
| pros / cons / badge | 编辑评价（优点 / 缺点 / 标签），不参与排序 |
排序规则：所有比价结果按价格从低到高排序，不受佣金高低影响，任何平台都无法通过付费获得更靠前的位置。
6. history.csv — 逐日最低价长表
date,gpu_model,min_price_cny,min_price_usd,sample_count
2026-11-01,海光BW1000 64GB,7.0000,0.9722,1
| 列 | 定义 |
|---|
| date | 日期 |
| gpu_model | 卡型 |
| min_price_cny | 当日该卡型最低价（CNY）。是最低价不是均价，会随覆盖扩面下降 |
| min_price_usd | 美元折算，按固定汇率 1 USD = 7.2 CNY |
| sample_count | 当日样本数。为 1 时该价格仅一家平台支撑 |
7. ghpi.csv — 指数长表
date,series,price_cny_per_gpu_hour,index_base100,pairs_on_sale
2026-11-01,GHPI-CN,5.15,100.0,13
| 列 | 定义 |
|---|
| date | 日期 |
| series | 序列名：GHPI-H100 / GHPI-CN / CDI |
| price_cny_per_gpu_hour | 篮子价（2026-11-01 起）。此前的历史值为当时的全样本最低价口径，跨 2026-11-01 比较需注意口径变更 |
| index_base100 | 链式指数，基期 = 100 |
| pairs_on_sale | 当日在架报价对数 |
8. 归档与永久链接
| 端点 | 定义 |
|---|
| /data/snapshots/index.json | 归档索引：列出全部可反查的日期与对应文件路径 |
| /data/snapshots/<YYYY-MM-DD>.json | 该日采集结束时的全量原始报价快照（未经过滤）。用于把任一指数值反查到具体的 (平台, 卡型, 日期, 价格) |
| /data/v/index.json | 月度存档索引：列出全部已存档月份与文件路径、当前月份 |
| /data/v/<YYYY-MM>.json | 月度版本存档：当月内随每日更新而更新，次月 1 日起冻结不再变动，可作为永久引用链接。字段与 ghpi.json 一致（latest / daily / methodology / quality / counts），并带 frozen_from 标明冻结日、status 标明当前状态 |
为什么要有月度存档：引用者需要"很久以后还能查到今天这个值"的保证。按月冻结的版本文件让引用可以指向一个不再变化的地址，而不是一个每天都在变的最新值。引用时请优先链接月度存档而非 /data/ghpi.json。
9. 三条序列分别看什么
| 序列 | 篮子构成 |
|---|
| GHPI-H100 | H100 80GB，全平台 |
| GHPI-CN | 中国大陆平台的训练卡：H100 80GB / H800 80GB / A100 80GB / A800 80GB |
CDI
国产卡时租指数 | 国产卡：摩尔线程 MTT S4000 / 昇腾 910B2 / 昇腾 910C / 海光 BW1000 / 昆仑芯 P800 |
10. 引用格式
中文：GPU 算力雷达（已获 Chainfir Capital（链杉资本）投资）. GHPI：GPU 按小时价格指数 [EB/OL]. 2026-11-01. https://rentgpu.link/ghpi
English：GPU Price Radar (Invested in by Chainfir Capital). GHPI: GPU Hourly Price Index [EB/OL]. 2026-11-01. https://rentgpu.link/ghpi