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.
Ogni endpoint seguente richiede una chiave API Enterprise. Gli altri piani ricevono 403 con required_grade: 2.
Endpoint
| Metodo | Percorso | Descrizione |
|---|---|---|
GET | /v1/dat/capital/entities | Società coperte e chiavi delle relative serie (livelli, ticker delle privilegiate, programmi ATM, sottostanti delle opzioni) |
GET | /v1/dat/capital/instruments | Struttura del capitale attuale, copertura in BTC e prezzo di rottura di ciascun livello di seniority, ultimi KPI |
GET | /v1/dat/capital/obligations | Obblighi di cassa mensili: interessi, dividendi delle privilegiate, put dei detentori, scadenze; asset in USD e runway |
GET | /v1/dat/capital/metrics | mNAV giornaliero (basic, diluted, EV), prezzo di BTC a mNAV = 1, BTC per azione diluita, obblighi, runway, diluizione |
GET | /v1/dat/capital/layers | Copertura giornaliera e prezzo di rottura in BTC di un livello di seniority (predefinito: il più junior) |
GET | /v1/dat/capital/preferreds | Chiusura giornaliera delle privilegiate, tasso, rendimento corrente e spread sul rendimento del Treasury a 10 anni |
GET | /v1/dat/capital/atm | Vendite ATM settimanali per programma: unità, proventi, capacità residua, % del volume scambiato |
GET | /v1/dat/capital/options | GEX giornaliero delle opzioni quotate su un sottostante (MSTR, IBIT, STRC, STRD, STRF) |
GET | /v1/dat/capital/options/profile | GEX e flusso di hedging dei dealer per livello di prezzo, GEX per strike, open interest per scadenza |
GET | /v1/dat/capital/scenarios | Griglia di scenari precalcolata (metodologia) |
URL di base: https://api.blocklens.co. Le risposte usano l'envelope {"success": true, "data": …}.
Parametri
| Parametro | Endpoint | Descrizione |
|---|---|---|
entity | tutti tranne le opzioni | Ticker delle azioni ordinarie della società, predefinito MSTR |
from_date, to_date | serie giornaliere / settimanali | Intervallo di date (YYYY-MM-DD) |
limit | serie giornaliere / settimanali | Righe più recenti mantenute (restituite dalla più vecchia) |
fields | /metrics | Colonne separate da virgole (date viene sempre restituito) |
layer | /layers | Chiave del livello da /entities, junior (predefinito) oppure all |
ticker | /preferreds | Ticker della privilegiata, ad es. STRC; predefinito: tutte le privilegiate |
program | /atm | Programma ATM, predefinito ALL (proventi di tutti i programmi; unità e % del volume delle azioni ordinarie) |
months | /obligations | Mesi in avanti, 1–60, predefinito 24 |
underlying, date, range_pct | /options, /options/profile | Sottostante (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
| Stato | Quando |
|---|---|
403 | La chiave non è Enterprise (required_grade: 2) |
404 | entity, livello o seduta sconosciuti, oppure nessun dato ancora calcolato |
400 | Valore di fields sconosciuto |
I dati descrivono documenti pubblici e prezzi di mercato. Non sono una previsione né una consulenza in materia di investimenti.