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.
Every endpoint below requires an Enterprise API key. Other tiers receive 403 with required_grade: 2.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v1/dat/capital/entities | Companies covered and the keys of their series (layers, preferred tickers, ATM programs, option underlyings) |
GET | /v1/dat/capital/instruments | Current capital stack, BTC coverage and break price of each seniority layer, latest KPIs |
GET | /v1/dat/capital/obligations | Monthly cash obligations: interest, preferred dividends, holder puts, maturities; USD assets and runway |
GET | /v1/dat/capital/metrics | Daily mNAV (basic, diluted, EV), BTC price at mNAV = 1, BTC per diluted share, obligations, runway, dilution |
GET | /v1/dat/capital/layers | Daily coverage and BTC break price of one seniority layer (default: the most junior) |
GET | /v1/dat/capital/preferreds | Daily preferred close, rate, current yield and spread over the 10-year Treasury yield |
GET | /v1/dat/capital/atm | Weekly ATM sales per program: units, proceeds, remaining capacity, % of trading volume |
GET | /v1/dat/capital/options | Daily GEX of the listed options on an underlying (MSTR, IBIT, STRC, STRD, STRF) |
GET | /v1/dat/capital/options/profile | GEX and dealer hedge flow across price levels, GEX by strike, open interest by expiry |
GET | /v1/dat/capital/scenarios | Precomputed scenario grid (methodology) |
Base URL: https://api.blocklens.co. Responses use the envelope {"success": true, "data": …}.
Parameters
| Parameter | Endpoints | Description |
|---|---|---|
entity | all except options | Company common-stock ticker, default MSTR |
from_date, to_date | daily / weekly series | Date range (YYYY-MM-DD) |
limit | daily / weekly series | Newest rows kept (returned oldest first) |
fields | /metrics | Comma-separated columns (date is always returned) |
layer | /layers | Layer key from /entities, junior (default) or all |
ticker | /preferreds | Preferred ticker, e.g. STRC; default: every preferred |
program | /atm | ATM program, default ALL (proceeds of every program; units and % of volume of the common stock) |
months | /obligations | Months ahead, 1–60, default 24 |
underlying, date, range_pct | /options, /options/profile | Underlying (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
| Status | When |
|---|---|
403 | The key is not Enterprise (required_grade: 2) |
404 | Unknown entity, layer or session, or no data built yet |
400 | Unknown fields value |
The data describes public filings and market prices. It is not a forecast and not investment advice.