Skip to main content

DAT Capital Structure API

The DAT Capital Structure API describes how a bitcoin treasury company funds its bitcoin: every convertible note, loan and preferred stock with its seniority, rate, maturity and holder put dates; how many times bitcoin and USD assets cover each seniority layer; the monthly calendar of interest and dividends; the market's view through mNAV and preferred yields; weekly at-the-market (ATM) issuance; and the dealer gamma exposure of the listed options on the company's securities. The pilot company is Strategy (MSTR).

Balances, share counts and instrument terms come from the company's SEC filings and are published only after review; between filings the latest reported balance plus reported weekly issuance is carried forward. Prices are daily closes on US trading days. Scenarios over BTC moves and horizons are a separate endpoint: Capital & stress scenarios.

Enterprise

Every endpoint below requires an Enterprise API key. Other tiers receive 403 with required_grade: 2.

Endpoints​

MethodPathDescription
GET/v1/dat/capital/entitiesCompanies covered and the keys of their series (layers, preferred tickers, ATM programs, option underlyings)
GET/v1/dat/capital/instrumentsCurrent capital stack, BTC coverage and break price of each seniority layer, latest KPIs
GET/v1/dat/capital/obligationsMonthly cash obligations: interest, preferred dividends, holder puts, maturities; USD assets and runway
GET/v1/dat/capital/metricsDaily mNAV (basic, diluted, EV), BTC price at mNAV = 1, BTC per diluted share, obligations, runway, dilution
GET/v1/dat/capital/layersDaily coverage and BTC break price of one seniority layer (default: the most junior)
GET/v1/dat/capital/preferredsDaily preferred close, rate, current yield and spread over the 10-year Treasury yield
GET/v1/dat/capital/atmWeekly ATM sales per program: units, proceeds, remaining capacity, % of trading volume
GET/v1/dat/capital/optionsDaily GEX of the listed options on an underlying (MSTR, IBIT, STRC, STRD, STRF)
GET/v1/dat/capital/options/profileGEX and dealer hedge flow across price levels, GEX by strike, open interest by expiry
GET/v1/dat/capital/scenariosPrecomputed scenario grid (methodology)

Base URL: https://api.blocklens.co. Responses use the envelope {"success": true, "data": …}.

Parameters​

ParameterEndpointsDescription
entityall except optionsCompany common-stock ticker, default MSTR
from_date, to_datedaily / weekly seriesDate range (YYYY-MM-DD)
limitdaily / weekly seriesNewest rows kept (returned oldest first)
fields/metricsComma-separated columns (date is always returned)
layer/layersLayer key from /entities, junior (default) or all
ticker/preferredsPreferred ticker, e.g. STRC; default: every preferred
program/atmATM program, default ALL (proceeds of every program; units and % of volume of the common stock)
months/obligationsMonths ahead, 1–60, default 24
underlying, date, range_pct/options, /options/profileUnderlying (default MSTR), session (default latest), profile window ± % of the close

Definitions​

  • mNAV (basic) = basic shares × stock price / (BTC holdings × BTC price). Diluted uses basic shares plus the if-converted shares of convertible notes and convertible preferred stock. EV adds the face value of debt and the liquidation preference of preferred stock to the market cap and subtracts USD assets (USD Reserve and cash).
  • Coverage of a layer = (BTC holdings × BTC price + USD assets) / claims senior to and including the layer. Break price = the BTC price at which that coverage equals 1.
  • Annual cash obligations = outstanding amount × current rate, summed over notes, loans and preferred stock. Runway = USD assets / one month of those obligations.
  • Preferred current yield = annual rate × liquidation preference / close; spread = yield − 10-year Treasury yield.
  • GEX = Σ ± open interest × 100 × gamma × price² / 100, in USD per 1% move, with dealers assumed long calls and short puts; gamma from each contract's implied volatility (Black-Scholes-Merton). Hedge flow at a level = USD dealers would buy (+) or sell (−) if the price moved there.

The same series are registry metrics (dat_cap_*, category DAT) available in the Lab and through MCP (get_dat_capital_structure, get_dat_capital_options).

Example​

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

Errors​

StatusWhen
403The key is not Enterprise (required_grade: 2)
404Unknown entity, layer or session, or no data built yet
400Unknown fields value
Not investment advice

The data describes public filings and market prices. It is not a forecast and not investment advice.