# NCSX-IS 数据集 v1.1（as of 2026-11-04）

**Neocloud Credit Spread Index — Issuance Spread**，AI 基础设施（Neocloud）发行人美元债券的**发行时点信用利差**基准。

13 只债券 · 6 家发行人 · $28.06B 面值 · 加权利差 **432.3 bp**（担保档 391.2 / 无担保档 540.1）。

| 项 | 值 |
|---|---|
| 方法论版本 | **v0.2.1-real**（2026-11-05 生效） |
| as-of | **2026-11-04** |
| 版本 DOI | [`10.5281/zenodo.23983572`](https://doi.org/10.5281/zenodo.23983572) |
| 概念 DOI（永远指向最新版） | [`10.5281/zenodo.23977166`](https://doi.org/10.5281/zenodo.23977166) |
| 数据许可 | **CC BY 4.0**（学术与非商业免费，署名即可） |
| 代码许可 | **MIT** |
| 在线方法论 | https://spreadbench.com/methodology.html |
| 授权条款 | https://spreadbench.com/license.html |

---

## 这是什么

一条**按未偿面值加权**的信用利差指数，衡量 AI 基础设施发行人（数据中心、GPU 云、算力租赁）在**发债定价那一刻**要求的风险补偿。

$$\text{spread}_i = (\text{coupon}_i - \text{UST}_i) \times 100 \quad\text{(bp)}$$
$$\text{NCSX-IS} = \frac{\sum_i \text{spread}_i \cdot \text{size}_i}{\sum_i \text{size}_i}$$

其中 `UST_i` 是该券**自己定价日**的美国国债 par yield 曲线在**实际剩余期限**处的线性插值（不外推）。

## 这不是什么

避免五类常见误引，这些是学术引用中最容易出错的地方：

1. **不是日更序列。** 事件驱动：只有新债定价时指数才变。没有日变动，没有「本周 ±x bp」。
2. **不是二级成交利差。** 用发行条款 + 定价日国债曲线，不用 TRACE 成交价，也不含 CDS。
3. **不是信用评级。** 不评主体、不给展望、不做投资建议。
4. **不是板块杠杆水平。** 它是「一组定义明确的子弹型公司债的平均发行利差」，不代表该板块整体负债结构。
5. **不含摊还型项目融资 SPV 债。** Hut 8 两笔（$7.5B）因此排除；机械并入会得到 **370.4 bp**——那是**反事实对照值，不是指数读数**（见 methodology §2）。

---

## 文件清单

| 文件 | 内容 |
|---|---|
| `data-dictionary.md` | **逐字段定义**（先读这个） |
| `NCSX-IS_universe.csv` | 13 只成分券：票息、到期、规模、定价日、国债收益率、逐券利差、SEC 原文链接 |
| `NCSX-IS_index.json` | 指数水位、分档水位、面值合计、口径限制、来源（v1.1 起含曲线调整读数字段 `revalued_*` 与分档发行人清单） |
| `readings_per_bond.csv` | **v1.1 新增**：逐券三读数（发行 / 曲线调整 / N-PORT 隐含），13 券全量，含逐券 Δ 与两条基准取值 |
| `amortisation_audit.json` | **v1.1 新增**：摊本条款逐券审计（9 券带完工后半年摊本 / 4 券子弹），条款照录 10-Q / 10-K 原文 |
| `issuer_debt_coverage.json` | **v1.1 新增**：六发行人债务覆盖率（本金口径、逐项出自最新 10-Q 债务附注；六家合计 42.8%） |
| `ust_curves_by_pricing_date.csv` | 13 个定价日的美国财政部 par yield 曲线（长表） |
| `ust_par_yield_2026-11-04.csv` | as-of 日单条曲线，仅用于对照重估，**不参与计算** |
| `sec_nport_marks.json` | L3 参考层：SEC N-PORT 申报的季度基金估值（7 券 / $15.37B / 616.4 bp），**非指数成分** |
| `sector_reference.json` | 板块参考：ICE BofA 高收益 OAS 等（FRED），**非指数成分** |
| `methodology_v0.2.1-real.md` | 方法论正文（资格、排除、公式、局限、反事实） |
| `recompute.py` | 独立复算脚本，**仅用 Python 标准库** |

## 30 秒复现

```bash
python recompute.py
```

输出逐券利差、分档加权与总指数（432.3 bp）**以及曲线调整读数（361.3 bp）**，两者均带断言。任何一步不符会抛错，不会静默通过。

要求：Python 3.8+，无第三方依赖。

---

## 引用

**正式引用（APA 7）**

> SpreadBench. (2026). *Neocloud Credit Spread Index — NCSX-IS, v0.2.1-real* (Version 0.2.1) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.23983572

**BibTeX**

```bibtex
@dataset{spreadbench_ncsxis_2026,
  author    = {{SpreadBench}},
  title     = {Neocloud Credit Spread Index --- {NCSX-IS}, v0.2.1-real},
  year      = {2026},
  month     = nov,
  publisher = {Zenodo},
  version   = {0.2.1-real},
  doi       = {10.5281/zenodo.23983572},
  url       = {https://doi.org/10.5281/zenodo.23983572},
  note      = {Issuance-date credit spreads of 13 USD bonds from 6 AI-infrastructure issuers; as of 2026-11-04}
}
```

**两个 DOI 怎么用**

- **精度优先**（论文复现、需要固定到某个版本）：用**版本 DOI** `10.5281/zenodo.23983572`。
- **长期链接**（引用「这个指数」本身、不锁定版本）：用**概念 DOI** `10.5281/zenodo.23977166`，它永远指向最新版。

两种写法都要求同时写出**方法论版本号**（本例 `v0.2.1-real`）与 **as-of 日期**——只写「NCSX」而不写版本，等于引用一个会变的数。

---

## 已知局限（主动披露）

1. **样本小但非抽样。** 13 只 = 该板块全部公开固定利率美元票据。其中 **CoreWeave 4 券为子弹公司债，其余 9 券（担保档全部）带「设施完工后半年摊还本金」条款**（数据中心项目融资惯例，逐券见 `amortisation_audit.json`）；Hut 8 的两笔 16 年期摊还型项目融资 SPV 债因期限结构不可比而排除。IREN / Nebius / Super Micro / Bitdeer 只发可转债；Crusoe / Lambda / Nscale / Fluidstack / GMI Cloud 为私有公司、无 SEC 申报义务。这是「观测点稀少」的如实记录，不是覆盖不足。
2. **跨定价日混合。** 各券利差锚定各自定价日（2025-05 至 2026-07），指数是横截面平均，不是同一时点的信用曲线。剥离利率环境用曲线调整读数 361.3（−71.0bp **全部来自国债曲线上移，不含信用**）；看信用本身用 N-PORT 基金季末估值隐含层 616.4（7 券）。三个读数各有名字，不可混用。
3. **无二级市场层。** 日更二级利差需要 FINRA TRACE 授权数据（v0.3.0 路线）。
4. **发行人集中。** 6 家发行人、13 只券，单家最大权重接近 1/3，个别发行人的条款差异会直接影响水位。

---

## 数据来源

- 票息 / 到期日 / 规模：SEC EDGAR 原文（每券 `src` 字段可逐条核验）
- 国债收益率：美国财政部 Daily Treasury Par Yield Curve
- 季度估值层：SEC EDGAR Form N-PORT（公开申报）

只聚合公开数据，不使用任何付费或私有数据源。

---

## 版本历史

- **v1.1（2026-11-12）**：①新增逐券摊本条款审计（修正 v1.0「子弹型公司债」的不准确表述：9/13 带完工后摊本条款）；②新增六发行人债务覆盖率（并修正 CoreWeave 覆盖率 28% → 21.8% 全口径）；③新增逐券三读数表；④`recompute.py` 曲线调整对照由已废止的「发行时原始期限」法（359.3）改为剩余期限法（361.3）。**指数读数、成分券与全部数值口径未变（432.3 / v0.2.1-real）。**
- **v1.0（2026-11-11）**：初版复现包。

## 联系

技术问题、复现不一致、数据集勘误：hi@spreadbench.com
发现错误请一并附上复算过程，我们会在方法论版本记录里公开勘误（v0.2.1 就是这样来的）。
