API de estructura de capital DAT
La API de estructura de capital DAT describe cómo financia su bitcoin una empresa de tesorería en bitcoin: cada bono convertible, préstamo y acción preferente con su prelación, tipo, vencimiento y fechas de put del tenedor; cuántas veces los activos en bitcoin y en USD cubren cada capa de prelación; el calendario mensual de intereses y dividendos; la visión del mercado a través del mNAV y de los rendimientos de las preferentes; la emisión semanal at-the-market (ATM); y la exposición gamma de los dealers en las opciones cotizadas sobre los valores de la empresa. La empresa piloto es Strategy (MSTR).
Los saldos, el número de acciones y las condiciones de los instrumentos proceden de los informes de la empresa ante la SEC y solo se publican tras su revisión; entre un informe y otro se arrastra el último saldo reportado más la emisión semanal reportada. Los precios son cierres diarios de los días hábiles bursátiles de EE. UU. Los escenarios sobre movimientos de BTC y horizontes son un endpoint aparte: Escenarios de capital y de estrés.
Todos los endpoints siguientes requieren una clave de API Enterprise. Los demás planes reciben 403 con required_grade: 2.
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
GET | /v1/dat/capital/entities | Empresas cubiertas y las claves de sus series (capas, tickers de preferentes, programas ATM, subyacentes de opciones) |
GET | /v1/dat/capital/instruments | Estructura de capital actual, cobertura en BTC y precio de ruptura de cada capa de prelación, últimos KPI |
GET | /v1/dat/capital/obligations | Obligaciones de caja mensuales: intereses, dividendos de preferentes, puts de tenedores, vencimientos; activos en USD y runway |
GET | /v1/dat/capital/metrics | mNAV diario (básico, diluido, EV), precio de BTC con mNAV = 1, BTC por acción diluida, obligaciones, runway, dilución |
GET | /v1/dat/capital/layers | Cobertura diaria y precio de ruptura de BTC de una capa de prelación (por defecto: la más subordinada) |
GET | /v1/dat/capital/preferreds | Cierre diario de la preferente, tipo, rendimiento corriente y diferencial sobre el rendimiento del bono del Tesoro a 10 años |
GET | /v1/dat/capital/atm | Ventas ATM semanales por programa: unidades, ingresos, capacidad restante, % del volumen negociado |
GET | /v1/dat/capital/options | GEX diario de las opciones cotizadas sobre un subyacente (MSTR, IBIT, STRC, STRD, STRF) |
GET | /v1/dat/capital/options/profile | GEX y flujo de cobertura de los dealers por niveles de precio, GEX por strike, interés abierto por vencimiento |
GET | /v1/dat/capital/scenarios | Cuadrícula de escenarios precalculada (metodología) |
URL base: https://api.blocklens.co. Las respuestas usan la envoltura {"success": true, "data": …}.
Parámetros
| Parámetro | Endpoints | Descripción |
|---|---|---|
entity | todos excepto options | Ticker de la acción ordinaria de la empresa, por defecto MSTR |
from_date, to_date | series diarias / semanales | Rango de fechas (YYYY-MM-DD) |
limit | series diarias / semanales | Filas más recientes conservadas (devueltas de la más antigua a la más reciente) |
fields | /metrics | Columnas separadas por comas (date se devuelve siempre) |
layer | /layers | Clave de capa de /entities, junior (por defecto) o all |
ticker | /preferreds | Ticker de la preferente, p. ej. STRC; por defecto: todas las preferentes |
program | /atm | Programa ATM, por defecto ALL (ingresos de todos los programas; unidades y % del volumen de la acción ordinaria) |
months | /obligations | Meses hacia adelante, 1–60, por defecto 24 |
underlying, date, range_pct | /options, /options/profile | Subyacente (por defecto MSTR), sesión (por defecto la última), ventana del perfil ± % del cierre |
Definiciones
- mNAV (básico) = acciones básicas × precio de la acción / (tenencias de BTC × precio de BTC). El diluido usa las acciones básicas más las acciones resultantes de la conversión de los bonos convertibles y de las acciones preferentes convertibles. El EV suma a la capitalización bursátil el valor nominal de la deuda y la preferencia de liquidación de las acciones preferentes, y resta los activos en USD (USD Reserve y efectivo).
- Cobertura de una capa = (tenencias de BTC × precio de BTC + activos en USD) / derechos de prelación superior a la capa, incluida esta. Precio de ruptura = el precio de BTC con el que esa cobertura es igual a 1.
- Obligaciones de caja anuales = importe en circulación × tipo actual, sumado sobre bonos, préstamos y acciones preferentes. Runway = activos en USD / un mes de esas obligaciones.
- Rendimiento corriente de la preferente = tipo anual × preferencia de liquidación / cierre; diferencial = rendimiento − rendimiento del bono del Tesoro a 10 años.
- GEX = Σ ± interés abierto × 100 × gamma × precio² / 100, en USD por movimiento del 1%, suponiendo que los dealers están largos en calls y cortos en puts; gamma a partir de la volatilidad implícita de cada contrato (Black-Scholes-Merton). Flujo de cobertura en un nivel = USD que los dealers comprarían (+) o venderían (−) si el precio se moviera hasta allí.
Las mismas series son métricas del registro (dat_cap_*, categoría DAT) disponibles en Lab y a través de
MCP (get_dat_capital_structure, get_dat_capital_options).
Ejemplo
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}]}
Errores
| Estado | Cuándo |
|---|---|
403 | La clave no es Enterprise (required_grade: 2) |
404 | entity, capa o sesión desconocida, o aún no se han generado datos |
400 | Valor de fields desconocido |
Los datos describen informes públicos y precios de mercado. No son una previsión ni asesoramiento de inversión.