Aller au contenu principal

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.

Enterprise

Chaque endpoint ci-dessous nécessite une clé d'API Enterprise. Les autres niveaux reçoivent 403 avec required_grade: 2.

Endpoints​

MéthodeCheminDescription
GET/v1/dat/capital/entitiesSocié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/instrumentsStructure du capital actuelle, couverture en BTC et prix de rupture de chaque couche de séniorité, derniers KPI
GET/v1/dat/capital/obligationsObligations 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/metricsmNAV quotidien (basic, dilué, EV), prix du BTC à mNAV = 1, BTC par action diluée, obligations, autonomie, dilution
GET/v1/dat/capital/layersCouverture quotidienne et prix de rupture du BTC d'une couche de séniorité (par défaut : la plus junior)
GET/v1/dat/capital/preferredsClô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/atmVentes ATM hebdomadaires par programme : unités, produit, capacité restante, % du volume de transactions
GET/v1/dat/capital/optionsGEX quotidien des options cotées sur un sous-jacent (MSTR, IBIT, STRC, STRD, STRF)
GET/v1/dat/capital/options/profileGEX et flux de couverture des dealers par niveau de prix, GEX par strike, intérêt ouvert par échéance
GET/v1/dat/capital/scenariosGrille 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ètreEndpointsDescription
entitytous sauf optionsTicker de l'action ordinaire de la société, par défaut MSTR
from_date, to_dateséries quotidiennes / hebdomadairesPlage de dates (YYYY-MM-DD)
limitséries quotidiennes / hebdomadairesNombre de lignes les plus récentes conservées (renvoyées de la plus ancienne à la plus récente)
fields/metricsColonnes séparées par des virgules (date est toujours renvoyée)
layer/layersClé de couche issue de /entities, junior (par défaut) ou all
ticker/preferredsTicker de l'action privilégiée, p. ex. STRC ; par défaut : toutes les actions privilégiées
program/atmProgramme ATM, par défaut ALL (produit de tous les programmes ; unités et % du volume de l'action ordinaire)
months/obligationsNombre de mois à venir, 1–60, par défaut 24
underlying, date, range_pct/options, /options/profileSous-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​

StatutCas
403La clé n'est pas Enterprise (required_grade: 2)
404entity, couche ou séance inconnue, ou aucune donnée encore construite
400Valeur de fields inconnue
Pas un conseil en investissement

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.