Passa al contenuto principale

DAT Capital Structure API

La DAT Capital Structure API descrive come una società di tesoreria in bitcoin finanzia i propri bitcoin: ogni obbligazione convertibile, prestito e azione privilegiata con la relativa seniority, il tasso, la scadenza e le date di put a favore dei detentori; quante volte gli asset in bitcoin e in USD coprono ciascun livello di seniority; il calendario mensile di interessi e dividendi; la valutazione del mercato attraverso mNAV e rendimenti delle azioni privilegiate; le emissioni settimanali at-the-market (ATM); e la gamma exposure dei dealer sulle opzioni quotate sui titoli della società. La società pilota è Strategy (MSTR).

Saldi, numero di azioni e termini degli strumenti provengono dai documenti depositati dalla società presso la SEC e vengono pubblicati solo dopo una revisione; tra un deposito e l'altro si riporta in avanti l'ultimo saldo dichiarato più le emissioni settimanali comunicate. I prezzi sono chiusure giornaliere nei giorni di borsa statunitensi. Gli scenari su movimenti di BTC e orizzonti temporali sono un endpoint separato: Scenari di capitale e di stress.

Enterprise

Ogni endpoint seguente richiede una chiave API Enterprise. Gli altri piani ricevono 403 con required_grade: 2.

Endpoint​

MetodoPercorsoDescrizione
GET/v1/dat/capital/entitiesSocietà coperte e chiavi delle relative serie (livelli, ticker delle privilegiate, programmi ATM, sottostanti delle opzioni)
GET/v1/dat/capital/instrumentsStruttura del capitale attuale, copertura in BTC e prezzo di rottura di ciascun livello di seniority, ultimi KPI
GET/v1/dat/capital/obligationsObblighi di cassa mensili: interessi, dividendi delle privilegiate, put dei detentori, scadenze; asset in USD e runway
GET/v1/dat/capital/metricsmNAV giornaliero (basic, diluted, EV), prezzo di BTC a mNAV = 1, BTC per azione diluita, obblighi, runway, diluizione
GET/v1/dat/capital/layersCopertura giornaliera e prezzo di rottura in BTC di un livello di seniority (predefinito: il più junior)
GET/v1/dat/capital/preferredsChiusura giornaliera delle privilegiate, tasso, rendimento corrente e spread sul rendimento del Treasury a 10 anni
GET/v1/dat/capital/atmVendite ATM settimanali per programma: unità, proventi, capacità residua, % del volume scambiato
GET/v1/dat/capital/optionsGEX giornaliero delle opzioni quotate su un sottostante (MSTR, IBIT, STRC, STRD, STRF)
GET/v1/dat/capital/options/profileGEX e flusso di hedging dei dealer per livello di prezzo, GEX per strike, open interest per scadenza
GET/v1/dat/capital/scenariosGriglia di scenari precalcolata (metodologia)

URL di base: https://api.blocklens.co. Le risposte usano l'envelope {"success": true, "data": …}.

Parametri​

ParametroEndpointDescrizione
entitytutti tranne le opzioniTicker delle azioni ordinarie della società, predefinito MSTR
from_date, to_dateserie giornaliere / settimanaliIntervallo di date (YYYY-MM-DD)
limitserie giornaliere / settimanaliRighe più recenti mantenute (restituite dalla più vecchia)
fields/metricsColonne separate da virgole (date viene sempre restituito)
layer/layersChiave del livello da /entities, junior (predefinito) oppure all
ticker/preferredsTicker della privilegiata, ad es. STRC; predefinito: tutte le privilegiate
program/atmProgramma ATM, predefinito ALL (proventi di tutti i programmi; unità e % del volume delle azioni ordinarie)
months/obligationsMesi in avanti, 1–60, predefinito 24
underlying, date, range_pct/options, /options/profileSottostante (predefinito MSTR), seduta (predefinita l'ultima), finestra del profilo ± % della chiusura

Definizioni​

  • mNAV (basic) = azioni basic × prezzo dell'azione / (BTC detenuti × prezzo di BTC). Diluted usa le azioni basic più le azioni derivanti dalla conversione delle obbligazioni convertibili e delle azioni privilegiate convertibili. EV aggiunge alla capitalizzazione di mercato il valore nominale del debito e la preferenza di liquidazione delle azioni privilegiate e sottrae gli asset in USD (USD Reserve e liquidità).
  • Copertura di un livello = (BTC detenuti × prezzo di BTC + asset in USD) / crediti con seniority superiore o pari al livello. Prezzo di rottura = il prezzo di BTC al quale tale copertura è pari a 1.
  • Obblighi di cassa annui = importo in essere × tasso attuale, sommato su obbligazioni, prestiti e azioni privilegiate. Runway = asset in USD / un mese di tali obblighi.
  • Rendimento corrente della privilegiata = tasso annuo × preferenza di liquidazione / chiusura; spread = rendimento − rendimento del Treasury a 10 anni.
  • GEX = Σ ± open interest × 100 × gamma × prezzo² / 100, in USD per movimento dell'1%, assumendo i dealer long sulle call e short sulle put; gamma dalla volatilità implicita di ciascun contratto (Black-Scholes-Merton). Flusso di hedging a un livello = USD che i dealer comprerebbero (+) o venderebbero (−) se il prezzo si spostasse lì.

Le stesse serie sono metriche del catalogo (dat_cap_*, categoria DAT) disponibili nel Lab e tramite MCP (get_dat_capital_structure, get_dat_capital_options).

Esempio​

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}]}

Errori​

StatoQuando
403La chiave non è Enterprise (required_grade: 2)
404entity, livello o seduta sconosciuti, oppure nessun dato ancora calcolato
400Valore di fields sconosciuto
Non è una consulenza finanziaria

I dati descrivono documenti pubblici e prezzi di mercato. Non sono una previsione né una consulenza in materia di investimenti.