API Structure du capital DAT
L'API Structure du capital DAT décrit comment une société de trésorerie bitcoin finance ses bitcoins : chaque obligation convertible, prêt et action privilégiée avec sa séniorité, son taux, son échéance et ses dates de put du porteur ; combien de fois les actifs en bitcoin et en USD couvrent chaque couche de séniorité ; le calendrier mensuel des intérêts et des dividendes ; la lecture du marché à travers le mNAV et les rendements des actions privilégiées ; les émissions at-the-market (ATM) hebdomadaires ; et l'exposition gamma des dealers sur les options cotées des titres de la société. La société pilote est Strategy (MSTR).
Les soldes, le nombre d'actions et les conditions des instruments proviennent des dépôts de la société auprès de la SEC et ne sont publiés qu'après vérification ; entre deux dépôts, le dernier solde déclaré, augmenté des émissions hebdomadaires déclarées, est reporté. Les prix sont des clôtures quotidiennes des jours de bourse américains. Les scénarios selon les variations du BTC et les horizons font l'objet d'un endpoint distinct : Scénarios de capital et de stress.
Chaque endpoint ci-dessous nécessite une clé d'API Enterprise. Les autres niveaux reçoivent 403 avec required_grade: 2.
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
GET | /v1/dat/capital/entities | Sociétés couvertes et clés de leurs séries (couches, tickers des actions privilégiées, programmes ATM, sous-jacents des options) |
GET | /v1/dat/capital/instruments | Structure du capital actuelle, couverture en BTC et prix de rupture de chaque couche de séniorité, derniers KPI |
GET | /v1/dat/capital/obligations | Obligations de trésorerie mensuelles : intérêts, dividendes privilégiés, puts des porteurs, échéances ; actifs en USD et autonomie |
GET | /v1/dat/capital/metrics | mNAV quotidien (basic, dilué, EV), prix du BTC à mNAV = 1, BTC par action diluée, obligations, autonomie, dilution |
GET | /v1/dat/capital/layers | Couverture quotidienne et prix de rupture du BTC d'une couche de séniorité (par défaut : la plus junior) |
GET | /v1/dat/capital/preferreds | Clôture quotidienne de l'action privilégiée, taux, rendement courant et écart par rapport au rendement du Treasury à 10 ans |
GET | /v1/dat/capital/atm | Ventes ATM hebdomadaires par programme : unités, produit, capacité restante, % du volume de transactions |
GET | /v1/dat/capital/options | GEX quotidien des options cotées sur un sous-jacent (MSTR, IBIT, STRC, STRD, STRF) |
GET | /v1/dat/capital/options/profile | GEX et flux de couverture des dealers par niveau de prix, GEX par strike, intérêt ouvert par échéance |
GET | /v1/dat/capital/scenarios | Grille de scénarios précalculée (méthodologie) |
URL de base : https://api.blocklens.co. Les réponses utilisent l'enveloppe {"success": true, "data": …}.
Paramètres
| Paramètre | Endpoints | Description |
|---|---|---|
entity | tous sauf options | Ticker de l'action ordinaire de la société, par défaut MSTR |
from_date, to_date | séries quotidiennes / hebdomadaires | Plage de dates (YYYY-MM-DD) |
limit | séries quotidiennes / hebdomadaires | Nombre de lignes les plus récentes conservées (renvoyées de la plus ancienne à la plus récente) |
fields | /metrics | Colonnes séparées par des virgules (date est toujours renvoyée) |
layer | /layers | Clé de couche issue de /entities, junior (par défaut) ou all |
ticker | /preferreds | Ticker de l'action privilégiée, p. ex. STRC ; par défaut : toutes les actions privilégiées |
program | /atm | Programme ATM, par défaut ALL (produit de tous les programmes ; unités et % du volume de l'action ordinaire) |
months | /obligations | Nombre de mois à venir, 1–60, par défaut 24 |
underlying, date, range_pct | /options, /options/profile | Sous-jacent (par défaut MSTR), séance (par défaut la plus récente), fenêtre du profil en ± % de la clôture |
Définitions
- mNAV (basic) = actions de base × cours de l'action / (BTC détenus × prix du BTC). Le mNAV dilué utilise les actions de base plus les actions issues de la conversion des obligations convertibles et des actions privilégiées convertibles. Le mNAV EV ajoute à la capitalisation boursière la valeur nominale de la dette et la préférence de liquidation des actions privilégiées, et en soustrait les actifs en USD (USD Reserve et liquidités).
- Couverture d'une couche = (BTC détenus × prix du BTC + actifs en USD) / créances de rang supérieur à la couche, celle-ci incluse. Prix de rupture = le prix du BTC auquel cette couverture est égale à 1.
- Obligations de trésorerie annuelles = encours × taux actuel, additionné sur les obligations, les prêts et les actions privilégiées. Autonomie = actifs en USD / un mois de ces obligations.
- Rendement courant d'une action privilégiée = taux annuel × préférence de liquidation / clôture ; écart = rendement − rendement du Treasury à 10 ans.
- GEX = Σ ± intérêt ouvert × 100 × gamma × prix² / 100, en USD par mouvement de 1 %, en supposant les dealers long calls et short puts ; gamma calculé à partir de la volatilité implicite de chaque contrat (Black-Scholes-Merton). Le flux de couverture à un niveau = les USD que les dealers achèteraient (+) ou vendraient (−) si le prix s'y déplaçait.
Les mêmes séries sont des métriques du catalogue (dat_cap_*, catégorie DAT) disponibles dans le Lab et via
MCP (get_dat_capital_structure, get_dat_capital_options).
Exemple
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}]}
Erreurs
| Statut | Cas |
|---|---|
403 | La clé n'est pas Enterprise (required_grade: 2) |
404 | entity, couche ou séance inconnue, ou aucune donnée encore construite |
400 | Valeur de fields inconnue |
Les données décrivent des dépôts publics et des prix de marché. Elles ne constituent ni une prévision ni un conseil en investissement.