DAT 资本结构 API
DAT 资本结构 API 描述比特币财库公司如何为其持有的 Bitcoin 融资:每一笔可转换债券、贷款和优先股及其清偿顺位、利率、到期日和持有人回售日期;Bitcoin 与 USD 资产对每个清偿顺位层级的覆盖倍数;利息和股息的月度日历;市场通过 mNAV 和优先股收益率给出的看法;每周按市价(ATM)发行情况;以及公司证券上市期权的做市商 Gamma 敞口。试点公司为 Strategy(MSTR)。
余额、股数和金融工具条款来自公司的 SEC 文件,经审核后才会发布;在两次申报之间,沿用最近一次申报的余额并加上已报告的每周发行量。价格为美国交易日的每日收盘价。针对 BTC 变动幅度和时间跨度的情景分析是单独的端点: 资本与压力情景。
Enterprise
以下所有端点都需要 Enterprise API 密钥。其他订阅层级会收到 403 及 required_grade: 2。
端点
| 方法 | 路径 | 描述 |
|---|---|---|
GET | /v1/dat/capital/entities | 覆盖的公司及其序列的键(层级、优先股代码、ATM 计划、期权标的) |
GET | /v1/dat/capital/instruments | 当前资本结构、每个清偿顺位层级的 BTC 覆盖倍数与击穿价格、最新 KPI |
GET | /v1/dat/capital/obligations | 月度现金债务:利息、优先股股息、持有人回售、到期;USD 资产与可支撑月数 |
GET | /v1/dat/capital/metrics | 每日 mNAV(基本、稀释、EV)、mNAV = 1 时的 BTC 价格、每稀释股 BTC、债务、可支撑月数、稀释 |
GET | /v1/dat/capital/layers | 单个清偿顺位层级的每日覆盖倍数与 BTC 击穿价格(默认:最次级层级) |
GET | /v1/dat/capital/preferreds | 每日优先股收盘价、利率、当期收益率及相对 10 年期美国国债收益率的利差 |
GET | /v1/dat/capital/atm | 每个计划的每周 ATM 销售:数量、所得款项、剩余额度、占交易量的百分比 |
GET | /v1/dat/capital/options | 某一标的(MSTR、IBIT、STRC、STRD、STRF)上市期权的每日 GEX |
GET | /v1/dat/capital/options/profile | 各价位上的 GEX 与做市商对冲资金流、按行权价的 GEX、按到期日的未平仓量 |
GET | /v1/dat/capital/scenarios | 预先计算的情景网格(方法论) |
基础 URL:https://api.blocklens.co。响应使用外层结构 {"success": true, "data": …}。
参数
| 参数 | 端点 | 描述 |
|---|---|---|
entity | 除期权外的全部端点 | 公司普通股代码,默认 MSTR |
from_date, to_date | 每日 / 每周序列 | 日期范围(YYYY-MM-DD) |
limit | 每日 / 每周序列 | 保留的最新行数(按从旧到新返回) |
fields | /metrics | 以逗号分隔的列(始终返回 date) |
layer | /layers | 来自 /entities 的层级键、junior(默认)或 all |
ticker | /preferreds | 优先股代码,例如 STRC;默认:全部优先股 |
program | /atm | ATM 计划,默认 ALL(所有计划的所得款项;普通股的数量及占交易量百分比) |
months | /obligations | 向前月数,1–60,默认 24 |
underlying, date, range_pct | /options, /options/profile | 标的(默认 MSTR)、交易时段(默认最新)、分布图窗口为收盘价的 ± % |
定义
- mNAV(基本) = 基本股数 × 股价 /(BTC 持仓 × BTC 价格)。稀释口径使用基本股数加上可转换债券和可转换优先股按转换计算的股数。EV 口径在市值基础上加上债务面值和优先股清算优先额,并减去 USD 资产(USD 储备和现金)。
- 层级覆盖倍数 =(BTC 持仓 × BTC 价格 + USD 资产)/ 优先于该层级及该层级本身的全部债权。 击穿价格 = 该覆盖倍数等于 1 时的 BTC 价格。
- 年度现金债务 = 未偿金额 × 当前利率,对债券、贷款和优先股求和。 可支撑月数 = USD 资产 / 一个月的上述债务。
- 优先股当期收益率 = 年利率 × 清算优先额 / 收盘价;利差 = 收益率 − 10 年期美国国债收益率。
- GEX = Σ ± 未平仓量 × 100 × gamma × 价格² / 100,单位为每 1% 变动的 USD,假设做市商持有看涨期权多头和看跌期权空头;gamma 由各合约的隐含波动率计算(Black-Scholes-Merton)。某价位的对冲资金流 = 若价格移动到该价位,做市商将买入(+)或卖出(−)的 USD 金额。
相同的序列也是注册表指标(dat_cap_*,类别 DAT),可在 Lab 中以及通过
MCP(get_dat_capital_structure、get_dat_capital_options)使用。
示例
curl -H "Authorization: Bearer $BLOCKLENS_API_KEY" \
"https://api.blocklens.co/v1/dat/capital/metrics?entity=MSTR&fields=mnav_basic,mnav_ev,runway_months&limit=5"
{"success": true, "entity": "MSTR", "count": 5,
"data": [{"date": "2026-11-13", "mnav_basic": 0.82, "mnav_ev": 1.08, "runway_months": 39.8}]}
错误
| 状态码 | 触发条件 |
|---|---|
403 | 密钥不是 Enterprise 级别(required_grade: 2) |
404 | 未知的 entity、层级或交易时段,或尚未生成数据 |
400 | 未知的 fields 值 |
非投资建议
这些数据描述的是公开申报文件和市场价格,既不是预测,也不构成投资建议。