Saltar al contenido principal

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.

Enterprise

Todos los endpoints siguientes requieren una clave de API Enterprise. Los demás planes reciben 403 con required_grade: 2.

Endpoints​

MétodoRutaDescripción
GET/v1/dat/capital/entitiesEmpresas cubiertas y las claves de sus series (capas, tickers de preferentes, programas ATM, subyacentes de opciones)
GET/v1/dat/capital/instrumentsEstructura de capital actual, cobertura en BTC y precio de ruptura de cada capa de prelación, últimos KPI
GET/v1/dat/capital/obligationsObligaciones de caja mensuales: intereses, dividendos de preferentes, puts de tenedores, vencimientos; activos en USD y runway
GET/v1/dat/capital/metricsmNAV diario (básico, diluido, EV), precio de BTC con mNAV = 1, BTC por acción diluida, obligaciones, runway, dilución
GET/v1/dat/capital/layersCobertura diaria y precio de ruptura de BTC de una capa de prelación (por defecto: la más subordinada)
GET/v1/dat/capital/preferredsCierre diario de la preferente, tipo, rendimiento corriente y diferencial sobre el rendimiento del bono del Tesoro a 10 años
GET/v1/dat/capital/atmVentas ATM semanales por programa: unidades, ingresos, capacidad restante, % del volumen negociado
GET/v1/dat/capital/optionsGEX diario de las opciones cotizadas sobre un subyacente (MSTR, IBIT, STRC, STRD, STRF)
GET/v1/dat/capital/options/profileGEX y flujo de cobertura de los dealers por niveles de precio, GEX por strike, interés abierto por vencimiento
GET/v1/dat/capital/scenariosCuadrícula de escenarios precalculada (metodología)

URL base: https://api.blocklens.co. Las respuestas usan la envoltura {"success": true, "data": …}.

Parámetros​

ParámetroEndpointsDescripción
entitytodos excepto optionsTicker de la acción ordinaria de la empresa, por defecto MSTR
from_date, to_dateseries diarias / semanalesRango de fechas (YYYY-MM-DD)
limitseries diarias / semanalesFilas más recientes conservadas (devueltas de la más antigua a la más reciente)
fields/metricsColumnas separadas por comas (date se devuelve siempre)
layer/layersClave de capa de /entities, junior (por defecto) o all
ticker/preferredsTicker de la preferente, p. ej. STRC; por defecto: todas las preferentes
program/atmPrograma ATM, por defecto ALL (ingresos de todos los programas; unidades y % del volumen de la acción ordinaria)
months/obligationsMeses hacia adelante, 1–60, por defecto 24
underlying, date, range_pct/options, /options/profileSubyacente (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​

EstadoCuándo
403La clave no es Enterprise (required_grade: 2)
404entity, capa o sesión desconocida, o aún no se han generado datos
400Valor de fields desconocido
No es asesoramiento de inversión

Los datos describen informes públicos y precios de mercado. No son una previsión ni asesoramiento de inversión.