Public API v1

Bitcoin Treasury Company Data Feed

CEBE Tracker publishes JSON endpoints covering the tracked universe. Companies serves the latest verified balance sheet and CEBE computation per company: BTC holdings, debt, preferred stock, cash, share counts, Senior Claims %, CEBE in satoshis per share, and CEBE mNAV. Instruments serves the capital structure those figures are computed from, one object per filed instrument. Deals serves the capital events between the snapshots. History serves the full snapshot series. The same construction is also served as dated embed images for anyone who wants the card rather than the JSON. The companies figures are also served to AI assistants through a read-only MCP server. Companies is open: no key, and free to use with attribution to cebetracker.io under the Terms of Use. Instruments, Deals and History are licensed integrations, available by API key; see Access and keys. Every field table below stands either way. CORS is enabled for any origin.

Access and keys

FeedAccess
companies.jsonOpen. No key. Free to use with attribution.
MCP serverOpen. No key. Serves the companies feed only, on the same terms.
instruments.jsonLicensed integration. Contact for access.
deals.jsonLicensed integration. Contact for access.
history.jsonLicensed integration. Contact for access.

The licensed feeds serve the underlying record rather than the published measurement. They are documented here in full, because a consumer deciding whether to license one should be able to read what it contains first. Keys are issued per integration, at CEBE Tracker's discretion; to request one, write to the address on the about page.

Send the key in the x-cebe-key request header. It is accepted in no other form: a key in a query string is written to server and proxy logs and travels with every link it appears in, so a key parameter is ignored and the request is refused as unkeyed.

curl -s https://cebetracker.io/api/v1/deals.json \
  -H 'x-cebe-key: YOUR_KEY'

A request with no key or an unrecognized one is refused with 401 and a one-line body naming this section. The key is checked before anything else the feed does, so an unkeyed request is answered 401 whatever its method, its ?ticker= or its If-None-Match. If the server's access list is not configured, every keyed feed refuses every request with 503 rather than serving open. Refusals carry Cache-Control: no-store. Preflight (OPTIONS) is answered 204 without a key, so a browser integration can negotiate CORS, and every v1 feed, the open one included, accepts the x-cebe-key header through preflight, so one client can send the key on every call.

{"error":"Unauthorized","message":"This feed is a licensed integration. Present an issued key in the x-cebe-key request header. Access: https://cebetracker.io/api/docs#access"}

The site's own pages also read /api/sheet-data. It is not a published feed and carries no contract. Since 2026-11-20 a public read of its Companies tab leaves out two working-text columns, description and key_feat, which are served only to a keyed request. The response names them in the X-CEBE-Keyed-Only header. No page renders either column, and no figure moves.

Top-level fields on the licensed feeds

FieldFeedsMeaning
versionall threeContract version. Currently 1.
as_ofall threeISO timestamp when the response was generated. Excluded from the ETag.
licenseall threeThe licensed-integration line, with the address of the Terms of Use.
terms_dateall threeDate of the Terms of Use revision in force (YYYY-MM-DD).
rules_versionhistoryVersion of the rules file every row in the payload was computed under. Each row carries the same stamp.
methodologyall threeURL of the methodology page.
tickerall threeThe canonical ticker ?ticker= resolved to, or null when the whole fleet is served.
row_countall threeTotal rows across every company in the response.
superseded_countdealsRows in the response carrying superseded: true.
normalizationdealsThe vocabulary aliases the reader applied, keyed by field, plus left_as_filed; see Vocabulary normalization.
status_vocabularyinstrumentsThe ratified instrument status tokens, the set status_recognized is tested against.
notesall threeMachine-readable description of the feed, its traps and its contract.
companiesall threeArray of per-company objects, documented under each feed.

Endpoint

GET https://cebetracker.io/api/v1/companies.json

Try it:

curl -s https://cebetracker.io/api/v1/companies.json

# CEBE per share and Senior Claims % for every company
curl -s https://cebetracker.io/api/v1/companies.json \
  | jq '.companies[] | {ticker, cebe_sats, senior_claims_pct, cebe_mnav}'

Methods: GET, HEAD, OPTIONS. The response is JSON with Access-Control-Allow-Origin: *, so browser apps can call it directly.

The two price bases

The feed serves the same construction on two explicit bases, and every price is dated.

Snapshot basis (filing-anchored)

Balance sheet figures come from each company's latest verified snapshot, sourced from primary filings (see the per-company source field). btc_price is the BTC/USD price on as_of, and senior_claims_pct and cebe_sats are computed at that price. cebe_mnav takes both of its prices at the row: the share close on the row (stock_close_row, converted at the row's exchange rate) over CEBE at btc_price, so the figure carries one date. A dated price is not stale data; it is the price at which the filing-anchored figures were anchored.

Live basis

btc_price_live is the current BTC/USD price (CoinGecko, or a backup live source when CoinGecko fails, named by btc_price_live_source and timestamped by btc_price_live_as_of). The senior_claims_pct_live, cebe_sats_live, and cebe_mnav_live fields recompute the identical formula with every price live, exchange rates included: a claim in another currency converts at the live cross named by fx_live_source and timestamped by fx_live_as_of, not at the row's rate, so fiat claims re-convert and the whole lens moves together. Live-basis fields are null when no live BTC price or no live cross is available.

The formula

Senior claims and CEBE are computed the same way on either basis. btc_price_basis is btc_price on the snapshot basis and btc_price_live on the live basis.

claims    = max(0, (debt_usd + preferred_usd - cash_usd - strc_holdings_usd)
                / btc_price_basis
                + btc_claim_static) / btc_holdings        # capped to [0, 1]

cebe_sats = btc_holdings * (1 - claims) / basic_shares    # in satoshis

cebe_mnav = stock_close_row / (cebe_sats / 1e8 * btc_price)                       # snapshot basis, both prices the row's
cebe_mnav_live = market_cap_usd / (btc_holdings * (1 - claims_live) * btc_price_live)   # live basis, every price live

senior_claims_pct is claims expressed as a percent, 0 to 100. The full measurement rules live on the methodology page.

Net Senior Claims carries three fiat terms, Debt plus Preferred less Cash, with strc_holdings_usd netting senior securities the issuer holds against itself. preferred_usd is carried at accrued liquidation preference, which is where declared but unpaid arrears live. dividends_payable_usd is served beside these figures as disclosure and is not summed into them.

Response shape

Top-level fieldMeaning
versionContract version. Currently 1.
as_ofISO timestamp when the response was generated.
licenseLicense line for the feed that served it: free to use with attribution on the open companies feed, and the licensed-integration line on a keyed feed. Full terms under Terms of Use.
terms_dateDate of the Terms of Use revision in force (YYYY-MM-DD). It changes with every revision; see Changes. Served on every v1 feed.
rules_versionVersion of the rules file every snapshot-basis figure in this payload is computed under (YYYY-MM-DD.n). When the rules change, the version moves, every row is recomputed, and each figure that moved is listed on the corrections log. The same version is served on each company and on every row of the snapshots tab. Current coverage by company is on /status/.
methodologyURL of the methodology page.
btc_price_liveCurrent BTC/USD price, or null when unavailable.
btc_price_live_as_ofTimestamp of the live price.
btc_price_live_sourceWhich live source produced btc_price_live: coingecko, or the backup source named when CoinGecko fails. null when no live price is available.
fx_live_sourceWhere the live crosses that convert claims in another currency on the live basis came from: coingecko, or the backup source's ECB crosses dated by fx_live_as_of. null when the crosses are not a live read (the dated snapshot crosses), in which case the live basis serves null.
fx_live_as_ofTimestamp of the live crosses: the instant of the CoinGecko payload they are derived from (the same payload as btc_price_live), or the ECB reference date behind the backup source. null when fx_live_source is.
fx_liveobject, nullThe live crosses used, US dollars per one unit of each currency by ISO code (rate is bitcoin in US dollars over bitcoin in that currency). null when fx_live_source is.
fx_sourceWhere the cross rates that convert non-USD stock quotes came from: the live source, ECB crosses behind the backup source, or the newest dated snapshot crosses when both live sources fail. null when no cross rate could be read, in which case non-USD quotes are withheld.
notesMachine-readable description of the bases, formula, and contract.
companiesArray of per-company objects, documented below.

Per-company field dictionary

FieldTypeMeaning
tickerstringCanonical ticker used across the site. Exchange aliases resolve to this key.
former_tickerstring, nullThe canonical ticker this company was served under before a rename, so a consumer holding rows under the old key can follow them. null for every company that has not been renamed.
namestringCompany display name.
as_ofstringDate of the latest verified balance sheet snapshot (YYYY-MM-DD).
pending_fieldsarray of stringsRequired fields the snapshot row does not state, from btc_holdings, shares_outstanding and btc_price (each must be positive) and debt_usd, preferred_usd and cash_usd (each must be stated and not negative; a stated zero is complete). Empty when the row is complete. When it is not empty the row is pending: the missing fields serve null, every computed figure on both bases serves null, and no earlier snapshot is substituted.
figures_held_reasonstring, nullWhere the row is held for its exchange rate, the stated reason served in place of the computed figures, FX rate for <date> not yet available; figure held, the same pattern as stock_price_withheld_reason. pending_fields then names fx_rate, and Senior Claims %, CEBE and the Adjusted fields serve null (adjusted_status reads held with the same reason). null otherwise.
btc_holdingsnumber, nullBTC held as of the snapshot date. null when the row does not state it.
debt_usdnumber, nullDebt outstanding, USD.
preferred_usdnumber, nullPreferred stock outstanding at accrued liquidation preference, USD.
cash_usdnumber, nullCash and equivalents, USD. Nets against senior claims.
strc_holdings_usdnumberSTRC preferred held as an asset, USD. Nets against senior claims. Not a required field: a blank cell means none held and serves 0, never null.
net_claims_usdnumber, nullNet senior claims as the issuer filed them, USD at the snapshot's own exchange rate, where an issuer files only a net figure (borrowings plus preferred less cash) without the components. When set, every claims figure in the record is computed from it in place of the four fiat terms. null when the snapshot carries components only.
net_claims_usd_verifiedboolean, nulltrue when the filed net figure is filing-verified, false when estimated (a preliminary filing is estimated until the full report is read against it), null when no net figure is served.
claims_basisstring"components" when claims are computed from debt, preferred, cash and issuer-held securities; "filed_net" when computed from net_claims_usd. The component fields are still served as carried on the row.
row_provenancestringWhere the row's balance sheet stands on the evidence it names: verified (the row's citation reads VERIFIED and nothing on it is marked estimated), est (any figure on the row is marked estimated, or the balance sheet is dated before the row and so carried forward) or unmarked (the row carries neither mark). A carried statement of absence, such as no debt carried from an earlier filing, reads est, not a verified zero. A mark, not a computation: no figure on the row moves with it.
row_est_fieldsarray of stringsThe fields the row marks estimated, sorted: each field whose estimate column on the row is set (named by the served field it feeds, or by its column stem, such as fd_shares, where the feed does not serve it), and debt_usd, preferred_usd and cash_usd where the balance sheet is carried forward. Empty when none is named. A row marked estimated only in its citation text reads est in row_provenance with this array empty.
rules_versionstringThe rules-file version this record was computed under. Equal to the payload's rules_version.
computed_from_rawbooleantrue when debt, preferred, cash, issuer-held securities, any filed net figure and basic shares were computed by the rules file from the row's raw filing cells (filing currency, converted at the row's fx_rate); false when the row's USD columns are served as filed.
balance_sheet_carriedboolean, nullWhen computed_from_raw is true: true when the filed balance sheet is dated before the row, so the figures are carried forward from the last report and are estimates; false when it is dated on the row date. null when the record is not computed from raw cells.
dividends_payable_usdnumber, nullDeclared but unpaid preferred dividends, USD, at face. Non-netting disclosure field: this is not an input to claims. preferred_usd carries accrued liquidation preference, so these arrears already sit inside it and adding this field would double-count them. null means not reported, 0 means none stands declared and unpaid.
deferred_tax_liability_usdnumber, nullThe deferred tax liability the filing states, USD. A non-netting disclosure, like dividends_payable_usd: deferred tax liabilities and minimum tax on unrealized gains are not senior claims and enter no figure in this feed, because they are a timing difference payable only if and when realized, and a tax realized lands inside existing balance sheet lines (cash). null where the row states none, 0 only where it states nil.
btc_claim_staticnumberBTC-denominated senior claims for BTC-indexed issuers. Price independent.
basic_sharesnumber, nullBasic common shares outstanding. null when the row does not state it.
btc_pricenumber, nullBTC/USD price the snapshot figures were anchored at. null when the row does not state it, never 0.
btc_price_as_ofstringDate of btc_price. Equals as_of.
senior_claims_pctnumber, nullShare of BTC holdings consumed by net senior claims at btc_price. Percent, 0 to 100. null when the row is pending.
cebe_satsinteger, nullCommon Equity Bitcoin Exposure per share, in satoshis, snapshot basis. null when the row is pending.
stock_pricenumber, nullLast available trade or close in USD, struck on the most recent real trade among the company's admitted venues. A quote-only venue never strikes, and a print older than the primary listing's last close never strikes. Quotes come from the same pipeline the site uses (Finnhub for US and OTC listings, Yahoo Finance for international venues), and non-USD prices convert at the cross rates named by fx_source. Never a live tick.
stock_price_as_ofstring, nullTimestamp of the quote. For a dated close (stock_price_print_kind close) it is the close date at 00:00 UTC, a date and not a trade time.
stock_price_sourcestring, nullWhich quote pipeline produced the price, in lower case, for example finnhub or yahoo, or yahoo daily for a dated close read from the daily series.
stock_price_venuestring, nullThe venue whose print struck stock_price. null when no quote strikes.
stock_price_withheld_reasonstring, nullWhy stock_price is null, stated in words: no admitted venue with a quote feed, no verifiable trade on any venue (a company priced from secondary venues whose quotes carried no trade time), no live cross for the quote currency, or the venue refusals. null whenever a price is served.
market_cap_usdnumber, nullstock_price times basic_shares.
cebe_mnavnumber, nullCEBE mNAV on the snapshot basis: the share close on the row, converted at the row's exchange rate (stock_close_row), over CEBE at the row's btc_price. Both prices are the row's. null with cebe_mnav_withheld_reason where the row has no close. Accretion threshold is 1.0.
stock_close_rownumber, nullThe share close on the row, in USD at the row's exchange rate, that cebe_mnav is struck on. null where the row carries no close.
stock_close_row_estboolean, nulltrue where the row marks its close estimated, false where it marks it filed, null where it carries no mark. An estimated close is served marked; no other close is put in its place.
cebe_mnav_withheld_reasonstring, nullWhy cebe_mnav is null, in words. null when it is a figure.
senior_claims_pct_livenumber, nullSenior Claims % on the live basis: recomputed at btc_price_live with claims in another currency converted at the live cross (fx_live_currency, fx_live_rate).
cebe_sats_liveinteger, nullcebe_sats on the live basis: recomputed at btc_price_live and the live cross.
cebe_mnav_livenumber, nullCEBE mNAV on the live basis: market_cap_usd over the USD value of common equity BTC at btc_price_live, claims at the live cross. null where stock_price or the live basis is.
fx_live_currencystring, nullThe currency whose live cross converted this company's claims on the live basis: its filing currency, or EUR for the euro preferred inside a US dollar total. null for a company with no claim in another currency.
fx_live_ratenumber, nullThat live cross, US dollars per one unit of fx_live_currency, four decimals. null when fx_live_currency is.
stock_price_nativenumber, nullThe struck quote in its own currency, before conversion to the USD stock_price. null when no quote strikes.
stock_price_currencystring, nullThe ISO currency of stock_price_native, for example GBP or BRL.
sats_per_100_stock_liveinteger, nullWhat $100 of the stock buys in CEBE sats on the live basis: cebe_sats_live / stock_price × 100, rounded.
stock_price_printstring, nullSet only where the company's primary listing has no feed and stock_price was struck on a secondary venue's trade: the print every stock-derived figure on the row was struck on, venue, ticker, price, currency and trade time, for example Print: OTC HOGPF US$0.142 at 2026-10-17 15:42 ET for a trade, or Print: OTC HOGPF US$0.2259, close 2026-10-16 for a dated close. Only a trade carrying its trade time, or a dated close whose day the source confirms traded volume above zero, is admitted; never a bid, an ask, a fixing or an indicative quote. null on a row priced on its primary listing.
stock_price_trade_atISO 8601 string, nullThe trade time of the print in stock_price_print, in UTC, for a trade. null for a close, which carries a date and no time, and when stock_price_print is.
stock_price_print_kindstring, nulltrade for a trade served with its trade time; close for a secondary venue's dated daily close, admitted only when the same source confirms that day's traded volume above zero. A trade wins over a close of the same date or earlier. null when stock_price_print is.
stock_price_print_dateYYYY-MM-DD string, nullThe venue-local date the print belongs to: the close date for a close, the trade's date for a trade. The staleness flag counts trading sessions from it. null when stock_price_print is.
stock_price_print_volumenumber, nullFor a close, that day's traded volume in shares as the source confirmed it (always above zero). null for a trade and when stock_price_print is.
stock_price_print_staleboolean, nulltrue when the print is more than five trading sessions old on its venue's calendar. The figures are still served on it; nothing is filled from a non-trade. null when stock_price_print is.
cebe_adjusted_satsinteger, nullAdjusted CEBE, sats per share: a valuation figure, not a measurement. Each admitted instrument in its expected state at the delivery prior of its moneyness band at the row's close: converts add expected shares and release the expected claim, cash-strike warrants and options add expected shares and expected exercise proceeds in BTC, share grants add expected shares, and combination-settlement notes keep principal as a claim and add the expected shares above it. Struck at btc_price like cebe_sats, on the same row. Served only where the company's serving gate passes: Adjusted CEBE lies between cebe_sats and the fully exercised figure, inclusive, and no instrument adds more than its own full delivery. null where the company holds, and where no adjustment applies (no admitted instrument moves the row, or a pending row).
cebe_adjusted_mnavnumber, nullAdjusted CEBE mNAV on the snapshot basis: the share close on the row (stock_close_row) over Adjusted CEBE valued at the row's btc_price, both prices the row's, as cebe_mnav. null where Adjusted CEBE is null or no dated quote is available.
cebe_adjusted_sats_liveinteger, nullAdjusted CEBE on the live basis: the same construction on the same row, with each admitted instrument's moneyness band, and so its delivery prior, read at stock_price (the struck quote, put in the instrument's currency at the live crosses, as is each face, strike and exercise proceeds in another currency), and claims and exercise proceeds in BTC at btc_price_live, as cebe_sats_live is. The serving gate runs again at that strike: null where the company holds there, whatever cebe_adjusted_sats serves, and where no adjustment applies. Additive, 2026-10-28.
cebe_adjusted_mnav_livenumber, nullAdjusted CEBE mNAV on the live basis: stock_price / (cebe_adjusted_sats_live / 1e8 × btc_price_live), the basis cebe_mnav_live uses. null wherever cebe_adjusted_sats_live is. Additive, 2026-10-28.
adjusted_status_livestring, nullReads as adjusted_status does, for the live strike: "est, prior under test; " followed by the side sentence at that strike where cebe_adjusted_sats_live is served, or "held, " followed by the reason where the gate fails there, for example "no live Bitcoin price" or that an instrument cannot be struck with no dated stock quote. null where no adjustment applies. Additive, 2026-10-28.
adjusted_priors_versionstring (date), nullPublication date of the delivery priors the adjusted figures use, set out on the priors page. null wherever cebe_adjusted_sats is null.
adjusted_statusstring, null"est, prior under test; " followed by the side sentence (see adjusted_side) wherever an adjusted figure is served. Where the company's serving gate fails, the three Adjusted figures serve null and this field reads "held, " followed by the reason, for example that the row carries no share price at its close. null where no adjustment applies.
adjusted_sidestring, nullWhere an adjusted figure is served, the side of Adjusted CEBE against cebe_sats in plain words, naming the leg class that moves it, for example "below standing: expected share grants outweigh expected exercise proceeds from warrants and options" or "above standing: expected exercise proceeds from warrants and options". null otherwise. Additive, 2026-10-11.
wrapper_costs_net_annual_usdnumber, nullThe Wrapper: the annual net cost to common equity from the costs tab, USD per year, rounded to the cent. It is the same figure the Annual Wrapper column on /credit/ and the company pages print. Positive is a cost to common equity; negative is net income to common equity (offsets exceed costs). Costs are summed for the latest period on the tab only, and a one-time payment is never annualised into it. null where the costs tab has no rows for the company, where the company's figure is withheld, or where an offset row's sign is not yet confirmed.
wrapper_costs_net_as_ofstring (date), nullThe newest last_updated date among the costs rows that make up wrapper_costs_net_annual_usd. null wherever that field is.
wrapper_annual_usdnumber, nullDeprecated 2026-11-08; use wrapper_costs_net_annual_usd. Still served, unchanged, until a removal date is announced to key holders. Annual carry cost of the wrapper (interest plus preferred dividends, net of any offsets recorded against them), USD, read from the snapshot row. It is a different construction from the costs-tab net and the two will not match. It can be negative where the recorded offsets exceed the carry.
wrapper_annual_usd_verifiedboolean, nullDeprecated 2026-11-08, with wrapper_annual_usd. true when the wrapper figure is filing-verified, false when estimated, null when no flag is recorded.
sourcestring, nullPrimary filing reference for the snapshot.

Stock-derived fields (stock_price, market_cap_usd and cebe_mnav_live) are null when no dated quote is available. cebe_mnav reads the row's own close instead and is null only where the row has none. The feed withholds a quote rather than serving it on a wrong currency basis.

Instruments feed

Licensed integration; contact for access. This feed needs an issued key in the x-cebe-key header; see Access and keys. The field documentation below is complete.

GET https://cebetracker.io/api/v1/instruments.json
GET https://cebetracker.io/api/v1/instruments.json?ticker=MSTR

Every row of the instruments record for the live fleet, grouped by company, in the record's own order. ?ticker= restricts the response to one company and accepts exchange aliases, so ?ticker=3350 and ?ticker=MTPLF reach the same company. A ticker outside the live universe returns 404 by name rather than an empty fleet.

This feed serves the capital structure, not the measurement. It computes no claim total, no Senior Claims % and no per-share figure, and a sum of face_value across these rows does not reproduce Net Senior Claims: the claim perimeter is a construction rather than a column sum, and the record deliberately carries rows outside it, including pre-active pools, retired instruments kept for history, and undrawn options recorded as instruments. Use companies.json for the measured figures.

# Active preferred and debt claims for one company
curl -s 'https://cebetracker.io/api/v1/instruments.json?ticker=MSTR' \
  -H 'x-cebe-key: YOUR_KEY' \
  | jq '.companies[0].instruments[] | select(.status_active) | {inst_id, class, face_value, rate}'

Field semantics that carry a trap

Blank reads as null, never as zero. On an instrument row a blank term was never filed, which is a different fact from a filed zero, and a consumer handed a zero cannot recover the blank.

face_value is blank on every share-delivery row by construction. That obligation is denominated in shares rather than a currency amount, so there is no face to file. face_value_applicable is false on exactly those rows, so a null never has to be interpreted.

The delivery pool carries its basis. share_delivery_pool.basis reads filed where the share count states the pool, proportional where the clause states a fraction of the diluted total and the count is solved from that fraction, and unresolved where neither shape is filed. A null count means not yet verified, never zero.

conversion_price carries the exercise price on a warrant, option or stock acquisition right, and a conversion price elsewhere. conversion_price_role names which, so the role never has to be inferred from a free-text class cell. A filed strike sits on the basis in force when it was filed, and those bases differ across the roster, so a moneyness screen must settle each issuer's split history before comparing a strike to a price series.

Status resolves through one reader. status is the ratified token, status_raw is the cell as typed, status_state gives the reading as one of active, pre_active, inactive or unrecognized, and status_active is the inclusion boolean the site's own surfaces gate on. A blank status resolves active by the standing absence rule. A value outside the ratified set is served with status_recognized: false and status_active: true, which is the inclusion the site applies, made visible rather than silent.

p_ref_immune lists the fields on that row carrying filed contractual terms: strikes, stated amounts, floors, caps and reference rates. Those terms are immune to every price, FX and basis sweep. Two live cases on this roster move in opposite directions at the same kind of corporate action, one warrant price left unadjusted at a reverse split and another raised by the split ratio, both correct as filed, which is why the flag exists rather than a rule of thumb.

Companies under review carry hold: true with a hold_reason. Their rows are served in full: a hold marks figures as under review and never blanks them.

Field dictionary

Each element of companies carries ticker, name, hold (boolean), hold_reason (string, or null when not held), instrument_count and instruments, one object per row of the record for that company, in the record's own order. A company with no rows is still listed, with an empty array. Each instrument object carries the fields below. Booleans read TRUE, YES or Y as true and FALSE, NO or N as false; anything else, blank included, is null.

FieldTypeMeaning
inst_idstring, nullInstrument identifier as filed. Deals join to it through instrument_id.
tickerstringCanonical ticker of the issuer.
issuerstring, nullIssuing entity as filed.
display_namestring, nullDisplay name as filed.
classstring, nullInstrument class as filed. Free text on a minority of rows.
typestring, nullInstrument type as filed. share_delivery marks an obligation denominated in shares.
currencystring, nullCurrency of face_value and of the filed terms, as filed.
statusstring, nullRatified status token. null where the cell is blank, which resolves active.
status_rawstring, nullThe status cell as typed.
status_statestringactive, pre_active, inactive or unrecognized.
status_activebooleanThe inclusion boolean the site's own surfaces gate on.
status_recognizedbooleanfalse where the status is outside status_vocabulary.
face_valuenumber, nullFace or principal as filed, in currency.
face_value_applicablebooleanfalse on exactly the share-delivery rows, where no currency face exists.
share_deliverybooleantrue where type is share_delivery.
share_delivery_poolobject, nullOn share-delivery rows: shares (number or null, the delivery count; null means not yet verified), basis (filed, proportional or unresolved), estimated (boolean), proportion (the stated fraction of the diluted total, or null) and base_shares (the share base a proportional pool is solved on, or null). null on every other row.
adjusted_classstring, nullOn share-delivery rows, the class the Adjusted CEBE layer computes this instrument as, or "not modeled" for earnouts and other equity-linked instruments the layer does not model. null on other rows and where the class is not on the layer's class table.
gate_typestring, nullThe gating condition on delivery, as filed.
lockup_expiry_datestring, nullLock-up expiry as filed.
conversion_pricenumber, nullConversion price, or the exercise price on a warrant, option or stock acquisition right. A filed term.
conversion_price_rolestring, nullconversion_price or exercise_price, naming which term conversion_price carries. null where no price is filed.
ratestring, nullCoupon or dividend rate as filed, as text.
rate_numericnumber, nullThe rate as a number.
rate_basisstring, nullWhat the rate is measured against.
rate_set_datestring, nullDate the rate in force was set.
rate_referencestring, nullReference rate for a floating or reset rate.
next_reset_datestring, nullNext scheduled rate reset.
rate_capnumber, nullCap on the rate.
rate_adjusts_below_parboolean, nullWhether the rate steps when the instrument trades below par.
rate_adjustment_stepnumber, nullSize of one rate step.
escalator_triggerstring, nullCondition that triggers a rate escalator.
escalator_ratenumber, nullRate once the escalator triggers.
escalator_activeboolean, nullWhether the escalator is in force.
compounding_cap_ratenumber, nullCap on compounding of unpaid amounts.
payment_typestring, nullHow payments are made, as filed.
payment_frequencystring, nullPayment cadence, as filed.
cash_payboolean, nullWhether the instrument pays in cash.
accrual_modestring, nullHow unpaid amounts accrue.
is_convertibleboolean, nullConvertibility flag as filed. Blank is null, not false, so filter convertibles on class or conversion_price as well.
is_cumulativeboolean, nullWhether unpaid dividends cumulate.
is_fxboolean, nullForeign-currency flag as filed.
maturitystring, nullMaturity or expiry as filed.
launchedstring, nullLaunch or issue date as filed.
earliest_put_datestring, nullEarliest holder put date.
senioritystring, nullSeniority as filed.
seniority_labelstring, nullSeniority description as filed. Free text, not a ranking this feed computes.
liq_pref_typestring, nullLiquidation preference type.
liq_pref_floornumber, nullLiquidation preference floor.
liq_pref_formulastring, nullLiquidation preference formula as filed.
share_payment_satisfiesboolean, nullWhether a payment in shares satisfies the obligation.
recurring_fee_annual_usdnumber, nullAnnual carry of the instrument, USD.
recurring_fee_annual_usd_estboolean, nulltrue when that figure is an estimate.
recurring_fee_annual_usd_notestring, nullBasis of that figure, as filed.
scheduled_amortization_12m_usdnumber, nullPrincipal scheduled to amortize over the next twelve months, USD.
scheduled_amortization_12m_usd_estboolean, nulltrue when that figure is an estimate.
scheduled_amortization_12m_usd_notestring, nullBasis of that figure, as filed.
source_url_mechanicsstring, nullURL of the filing the terms come from.
source_filing_mechanicsstring, nullThe filing the terms come from, by name or accession.
p_ref_immunearray of stringsThe fields on this row that carry a filed contractual term, from face_value, conversion_price, rate, rate_numeric, rate_cap, rate_adjustment_step, rate_reference, liq_pref_floor, liq_pref_formula, compounding_cap_rate, escalator_trigger and escalator_rate.

Deals feed

Licensed integration; contact for access. This feed needs an issued key in the x-cebe-key header; see Access and keys. The field documentation below is complete.

GET https://cebetracker.io/api/v1/deals.json
GET https://cebetracker.io/api/v1/deals.json?ticker=MSTR

Every row of the capital events record for the live fleet, grouped by company, oldest first so the newest print is last. Purchases and sales, ATM prints, preferred and convertible issuance, repurchases, repayments and conversion triggers, each carrying the filing it came from. ?ticker= behaves as it does on the instruments feed.

Nothing is computed. Every field is the record's own cell, and this feed applies no accretion test, derives no per-share figure and totals nothing, because a total over event rows is a construction with rules of its own.

Before summing anything

Superseded rows are corrections, not events. A row whose data_quality is SUPERSEDED carries superseded: true and must be excluded from every total. It is served rather than dropped so a consumer reconciling against the filings can see what was corrected.

At least one event is recorded twice under two ids, and both rows are served. A feed that quietly drops rows cannot be reconciled against the filings. The known case is the STRC repurchase week to 26 July 2026, carried as MSTR-2026-07-26-01 and MSTR-2026-07-27-01, both marked VERIFIED, both citing 8-K accession 0001193125-26-316917, and both stating the same 288,930 shares and the same $28,893,000 of face. The companion ATM print for that week is carried twice in the same way. Summing claims_added_usd for that company without de-duplicating overstates retired face by $28,893,000.

Vocabulary normalization

The record carries the same fact under two spellings in three columns, and the sweep settling that at source has not landed. The normalization is applied in the reader, printed in the response's normalization field, and listed here. Every entry is a spelling pair evidenced in the record itself rather than a judgment about what two different words ought to mean.

FieldAs filedAs served
deal_typepref_repurchasepreferred_repurchase
deal_typeatm_commonatm_equity
deal_typeatm_preferredpreferred_issuance
deal_typesubscription_placementequity_placement
deal_typeacquisition, collateral_pledge, debt_restructureother
directionissueraise
data_qualityESTESTIMATED

The atm_preferred, subscription_placement, acquisition, collateral_pledge and debt_restructure entries are the deal type list as revised on 20 October 2026: the record is being moved to the new values, and the feed serves the new value for both spellings throughout. The filed value stays in deal_type_raw.

The atm_common and issue entries come from the duplicate pair above, where one 8-K is recorded once as atm_equity with direction raise and once as atm_common with direction issue, which is the record stating the equivalence in its own hand.

Every row carries the cell as filed in deal_type_raw, direction_raw and data_quality_raw, and vocabulary_normalized lists which of its fields were rewritten, so nothing is lost and the sweep can be checked against this feed afterwards.

Directions left as filed: deploy, dispose, retire, in and pledge. Those are not spellings of one word. dispose sits beside deploy on sale rows and retire beside deploy on repayment and repurchase rows, describing the cash leg and the claim leg of one event; in and pledge appear once each, on an acquisition close and a collateral pledge, with no second row to establish a mapping.

Joins and estimates

instrument_id joins to the instruments feed on inst_id, and the join is not clean on every row: the record carries both MSTR_STRC and STRC for one instrument across different weeks. The value is served exactly as filed, because rewriting an identifier to make a join succeed hides the defect rather than reporting it.

funding_group links the legs of one financing at announcement level only. Where a filing states no use of proceeds, the link is not a claim that the proceeds bought the coin.

shares_issued, net_proceeds and stock_price_at_deal each carry an _est boolean and a _note beside them, so an estimate never has to be inferred. stock_price_at_deal is the price as filed at the deal and never a live quote, because an accretion test run against today's price answers a different question from the one the print poses.

Field dictionary

Each element of companies carries ticker, name, hold (boolean), hold_reason (string, or null when not held), deal_count, superseded_count and deals, oldest first by reported_date, ties in the record's own order. A company with no rows is still listed, with an empty array. Each deal object carries the fields below. Blank reads as null, never as zero, and booleans read as on the instruments feed.

FieldTypeMeaning
deal_idstring, nullEvent identifier as filed.
tickerstringCanonical ticker of the issuer.
reported_datestring, nullDate of the filing that reported the event (YYYY-MM-DD). The sort key.
event_datestring, nullDate the event completed as the filing states it. null where the filing states a period or only a signing; it is never filled from reported_date.
deal_typestring, nullEvent type, normalized; see Vocabulary normalization.
deal_type_rawstring, nullEvent type as filed.
directionstring, nullDirection, normalized.
direction_rawstring, nullDirection as filed.
data_qualitystring, nullData quality, normalized, for example VERIFIED, ESTIMATED or SUPERSEDED.
data_quality_rawstring, nullData quality as filed.
vocabulary_normalizedarray of stringsWhich of deal_type, direction and data_quality the reader rewrote on this row. Empty where none was.
supersededbooleantrue where data_quality is SUPERSEDED. Exclude from every total.
instrument_idstring, nullJoins to inst_id on the instruments feed; see Joins and estimates.
funding_groupstring, nullLinks the legs of one financing, at announcement level.
btc_amountnumber, nullBTC moved by the event, as filed.
btc_pricenumber, nullBTC price the filing states for the event.
shares_issuednumber, nullShares issued by the event, as filed.
shares_issued_estboolean, nulltrue when that count is an estimate.
shares_issued_notestring, nullBasis of that count, as filed.
claims_addednumber, nullSenior claims added (positive) or retired (negative), in claims_currency.
claims_currencystring, nullCurrency of claims_added.
claims_added_usdnumber, nullclaims_added in USD.
net_proceedsnumber, nullNet proceeds of the event, as filed.
net_proceeds_estboolean, nulltrue when that figure is an estimate.
net_proceeds_notestring, nullBasis of that figure, as filed.
fx_ratenumber, nullCross rate the record carries for a non-USD event.
stock_price_at_dealnumber, nullThe issuer's stock price at the event, as filed. Never a live quote.
stock_price_at_deal_estboolean, nulltrue when that price is an estimate.
stock_price_at_deal_notestring, nullBasis of that price, as filed.
source_urlstring, nullURL of the filing.
sourcestring, nullThe filing by name or accession.

Conditional requests

The instruments and deals feeds serve a strong ETag over the exact bytes returned, excluding the generation timestamp, so an unchanged record yields an unchanged validator. Send it back as If-None-Match and an unchanged feed answers 304 with no body.

curl -s -D - -o /dev/null -H 'x-cebe-key: YOUR_KEY' \
  https://cebetracker.io/api/v1/instruments.json | grep -i etag
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'x-cebe-key: YOUR_KEY' \
  -H 'If-None-Match: "PASTE_THE_ETAG_HERE"' \
  https://cebetracker.io/api/v1/instruments.json

A 304 is answered only to a keyed request. An unkeyed request carrying a current ETag is refused with 401, never told its copy is current.

History endpoint

Licensed integration; contact for access. This feed needs an issued key in the x-cebe-key header; see Access and keys. The field documentation below is complete.

companies.json serves each company's latest snapshot. history.json serves every snapshot row the tracker holds, so a series can be plotted without reconstructing it by hand from published figures.

GET https://cebetracker.io/api/v1/history.json
GET https://cebetracker.io/api/v1/history.json?ticker=MSTR

Try it:

curl -s 'https://cebetracker.io/api/v1/history.json?ticker=MSTR' \
  -H 'x-cebe-key: YOUR_KEY' \
  | jq '.companies[0].rows[] | {snapshot_date, cebe_sats, senior_claims_pct, amplification}'

Without ?ticker= the whole live fleet is served. The parameter accepts exchange aliases, so ?ticker=3350 and ?ticker=MTPLF reach the same company. A ticker outside the live universe returns 404 with the reason, rather than an empty fleet that would read as a company with no history.

Each company object carries ticker, name, a hold flag with its hold_reason, and rows, ordered oldest first so the newest row is last. A company under review carries hold: true and serves its rows in full: the flag marks the figures as under review and does not blank them.

Computed per row, nothing stored

Every computed field is recomputed for each row from the same shared modules the site's own pages use, at that row's own btc_price. No figure is read from a stored claims column, and no row is marked to a live price. A row's raw fields and its computed fields therefore always reproduce one another.

Row fieldTypeMeaning
snapshot_datestringDate of the snapshot (YYYY-MM-DD).
rules_versionstringVersion of the rules file (config/rules.js) the row was computed under, the same stamp companies.json serves. Every row in one response carries the same version, also served once on the payload.
pending_fieldsarray of stringsRequired inputs the row lacks. Empty when the row computes; otherwise every computed field on the row is null and break_even_reason states why.
figures_held_reasonstring, nullWhere the row is held for its exchange rate, the stated reason its computed fields serve null: FX rate for <date> not yet available; figure held. null otherwise.
claims_basisstringcomponents, or filed_net where the issuer files only a net claims figure and the row is computed from it.
net_claims_usdnumber, nullThe filed net senior claims figure where claims_basis is filed_net; null otherwise.
computed_from_rawbooleantrue where the row's balance sheet was computed by the rules file from its raw filing cells.
btc_holdingsnumber, nullBTC held on that date.
debt_usdnumber, nullDebt outstanding, USD.
preferred_usdnumber, nullPreferred outstanding at accrued liquidation preference, USD.
cash_usdnumber, nullCash and equivalents including short-term investments, USD, as carried on the Snapshots tab. Nets against senior claims.
strc_holdings_usdnumberSTRC preferred held as an asset, USD, as carried on the Snapshots tab. Nets against senior claims, and is served so each row reproduces from its own fields.
btc_claim_staticnumberBTC-denominated senior claims, price independent. An explicit 0 means the claim was retired, which is a different fact from a company that never carried one.
shares_outstandingnumber, nullBasic common shares as filed. Never fully diluted.
btc_pricenumber, nullBTC/USD price the row's figures are anchored at, and the price every computed field on the row uses.
fx_ratenumber, nullCross rate applied to a non-USD reporting currency, or null where the row needs none.
sourcestring, nullPrimary filing reference for the row.
is_partialbooleantrue where the row covers part of a period rather than a full one. A series that hides this reads a stub as a quarter.
net_senior_claims_usdnumber, nullNet senior claims valued at btc_price, USD.
net_senior_claims_btcnumber, nullNet senior claims in BTC, floored at zero on the netted total.
cebe_satsnumber, nullCommon Equity Bitcoin Exposure per basic share, in satoshis.
senior_claims_pctnumber, nullShare of holdings consumed by net senior claims, percent, 0 to 100.
common_equity_pctnumber, null100 - senior_claims_pct.
amplificationnumber, nullCEBE Amplification, the elasticity of common equity's Bitcoin exposure to the Bitcoin price. Computed on unfloored senior claims with the BTC-indexed bucket netted out of the numerator, so a net-cash issuer correctly reports below 1.0. null at or above 100% claims, where the figure is undefined rather than infinite.
break_evennumber, nullBTC price at which senior claims consume the whole treasury. Solves the fiat leg only.
break_even_reasonstring, nullWhy break_even is null, stated in words. Exactly one of the two is non-null, so a null is never bare.
net_senior_claims_btc = max(0, (debt_usd + preferred_usd - cash_usd - strc_holdings_usd)
                               / btc_price + btc_claim_static)

senior_claims_pct     = net_senior_claims_btc / btc_holdings x 100   # clamped to [0, 100]

cebe_sats             = (btc_holdings - net_senior_claims_btc)
                        / shares_outstanding x 100,000,000

amplification         = (1 - indexed_share) / (1 - senior_share_unfloored)   # CEBE Amplification

break_even            = (debt_usd + preferred_usd - cash_usd - strc_holdings_usd)
                        / (btc_holdings - btc_claim_static)

Rounding is applied at output and never to an intermediate: net_senior_claims_usd and break_even to 2 decimals, net_senior_claims_btc to 8, cebe_sats to whole satoshis as the rules file serves them, and senior_claims_pct, common_equity_pct and amplification to 6.

Conditional requests

Responses carry an ETag over the payload. Send it back as If-None-Match and an unchanged upstream returns 304 Not Modified with no body, which is the cheap way to poll for a new filing.

curl -s -D- -o /dev/null \
  -H 'x-cebe-key: YOUR_KEY' \
  -H 'If-None-Match: "<etag from the previous response>"' \
  'https://cebetracker.io/api/v1/history.json?ticker=MSTR'

Cite as

CEBE Tracker, Bitcoin Treasury Company snapshot history, cebetracker.io/api/v1/history.json, retrieved <date>.

MCP server

A read-only Model Context Protocol server, for AI assistants and agents that read the figures as tools rather than as a JSON feed. It serves what the open companies feed serves, read through that feed's own code, so a figure from a tool and the same field in companies.json are one figure.

POST https://cebetracker.io/api/v1/mcp

Scope. The server serves the open companies feed and nothing else. It serves no Claims Grade figures and no Adjusted CEBE figures. It needs no key, never reads one, and serves nothing from the licensed feeds (instruments, deals and history).

Transport

MCP Streamable HTTP, stateless, JSON-RPC 2.0. Each POST carries one message, or a batch as an array, with Content-Type: application/json, and is answered with one application/json body. No session is issued (there is no Mcp-Session-Id) and no event stream is offered, so GET and DELETE answer 405. A POST that carries only notifications answers 202 with no body. Protocol versions 2025-11-25, 2025-06-18 and 2025-03-26 are accepted; initialize answers the version the client asks for when it is one of these, and the newest otherwise. An MCP-Protocol-Version header naming any other version answers 400.

MethodAnswer
initializeThe protocol version, the tools capability, the server name and a short instruction to publish the basis and the date with any figure.
pingAn empty result.
tools/listThe two tools below, each with its input and output schema.
tools/callThe tool's result, as structuredContent and as the same JSON in one text block.

Any other method answers the JSON-RPC error -32601. A body that is not JSON answers 400 with -32700; a message that is not JSON-RPC 2.0 answers 400 with -32600; an unknown tool name answers -32602. An unknown ticker is a tool error: the result carries isError: true and a sentence naming the ticker and listing the tickers served. CORS is open to any origin. Responses carry Cache-Control: no-store; the server holds a successful read of the feed for up to 60 seconds, inside the feed's own five-minute cache. Requests are rate-limited to 100 per minute per IP, and over-limit requests receive 429 with Retry-After: 60.

The two tools

ToolInputOutput
get_company{"ticker": string}, required. Case does not matter, and exchange aliases resolve to the ticker the site files the company under.The envelope below, plus company: one company object.
list_companies{}, no arguments.The envelope below, plus companies: every company the feed serves, in the site's company order (BTC held, largest first).

The envelope, on both tools:

FieldTypeMeaning
source_feedstringhttps://cebetracker.io/api/v1/companies.json, the feed the figures are read from.
feed_as_ofstring, nullThe feed's own as_of: when the feed body was built.
rules_versionstring, nullThe feed's rules_version.
licensestring, nullThe feed's license line.
terms_datestring, nullThe feed's terms_date.
attributionstringThe citation the Terms of Use ask for: Data via CEBE Tracker, cebetracker.io.
methodologystringURL of the methodology page.
cebe_definition_sourcestringThe page that carries the definition sentence, https://cebetracker.io/glossary/.
field_labelsobjectThe house name of each figure and its basis, keyed by field name, for a client that prints a label.

Each company object:

FieldTypeMeaning
tickerstringThe ticker the site files the company under.
namestringCompany display name.
company_page_urlstringThe company page, https://cebetracker.io/company/{TICKER}/.
as_ofstring, nullDate of the snapshot row the figures are read from (YYYY-MM-DD), the feed's as_of.
source_accessionstring, nullThe first SEC accession number in source. null where the row's filing is not an EDGAR filing; source then names it.
sourcestring, nullThe feed's source: the filing reference for the row.
rules_versionstring, nullThe rules-file version the row was computed under.
pending_fieldsarrayRequired fields the row lacks. When any is named, every computed figure is null.
figures_held_reasonstring, nullWhere the row is held for its exchange rate, the reason; null otherwise.
cebe_definitionstringThe definition of CEBE as the site states it.
snapshot_basisobjectbasis: "snapshot", a description, and btc_price, btc_price_as_of, cebe_sats, senior_claims_pct and cebe_mnav: the figures at the row's own btc_price, exactly as the feed serves them.
live_basisobjectbasis: "live", a description, and btc_price_live, btc_price_live_as_of, btc_price_live_source, cebe_sats_live, senior_claims_pct_live and cebe_mnav_live: the same construction at the live BTC price, exactly as the feed serves them.
stock_pricenumber, nullThe USD stock price both CEBE mNAV figures are struck on.
stock_price_as_ofstring, nullIts timestamp.
stock_price_withheld_reasonstring, nullWhy no price could strike, when stock_price is null.

Every figure keeps the meaning, the rounding and the null rules it has in the field dictionary above. The tool output names each field it serves and nothing else.

Example

A request:

curl -s https://cebetracker.io/api/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_company","arguments":{"ticker":"MSTR"}}}'

The response's structuredContent, from the feed as read on 28 October 2026, with source, the descriptions and field_labels shortened and the text block (the same JSON) left out:

{
  "source_feed": "https://cebetracker.io/api/v1/companies.json",
  "feed_as_of": "2026-10-28T15:24:28.265Z",
  "rules_version": "2026-10-28.1",
  "license": "Free to use with attribution to cebetracker.io",
  "terms_date": "2026-09-11",
  "attribution": "Data via CEBE Tracker, cebetracker.io",
  "methodology": "https://cebetracker.io/methodology/",
  "cebe_definition_source": "https://cebetracker.io/glossary/",
  "field_labels": { "cebe_sats": "CEBE, sats per basic share, snapshot basis", ... },
  "company": {
    "ticker": "MSTR",
    "name": "Strategy",
    "company_page_url": "https://cebetracker.io/company/MSTR/",
    "as_of": "2026-10-26",
    "source_accession": "0001193125-26-431146",
    "source": "8-K filed 2026-10-26, acc 0001193125-26-431146, covering 2026-10-19 to 2026-10-25, ...",
    "rules_version": "2026-10-28.1",
    "pending_fields": [],
    "figures_held_reason": null,
    "cebe_definition": "CEBE (Common Equity Bitcoin Exposure) is the Bitcoin each common share owns once every senior claim has been netted against total Bitcoin holdings, published in satoshis per basic share.",
    "snapshot_basis": {
      "basis": "snapshot",
      "description": "Snapshot basis: computed at btc_price, the BTC/USD price on the row's own as_of date, ...",
      "btc_price": 80048.85,
      "btc_price_as_of": "2026-10-26",
      "cebe_sats": 156436,
      "senior_claims_pct": 22.15,
      "cebe_mnav": 1.12
    },
    "live_basis": {
      "basis": "live",
      "description": "Live basis: the same construction recomputed at btc_price_live, the current BTC/USD price, ...",
      "btc_price_live": 80616,
      "btc_price_live_as_of": "2026-10-28T15:24:28.000Z",
      "btc_price_live_source": "coingecko",
      "cebe_sats_live": 156749,
      "senior_claims_pct_live": 21.99,
      "cebe_mnav_live": 1.11
    },
    "stock_price": 140.3,
    "stock_price_as_of": "2026-10-28T15:24:09.000Z",
    "stock_price_withheld_reason": null
  }
}

An unknown ticker:

{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text",
  "text":"No company with ticker ZZZZ is served by the public feed. Tickers served: MSTR, ..."}],"isError":true}}

To add it to an MCP client that takes a remote server by URL, give it https://cebetracker.io/api/v1/mcp. The Terms of Use apply as they do to the feed: a figure an assistant repeats carries its basis, its date and the citation.

Caching and limits

The open companies feed is CDN-cached for about five minutes (the function sends public, s-maxage=300, stale-while-revalidate=600; the CDN consumes the shared-cache directives, so a client sees Cache-Control: public and can read the cached copy's age from the Age header); after the first five minutes the CDN serves that copy for up to ten more while it refreshes it. The Sheet tabs the site's own pages read are held for up to one hour (s-maxage=300, stale-while-revalidate=3300). After each write to the data Sheet, the cached tabs and the open companies feed are marked out of date and refreshed on the next read, so a change shows within seconds rather than at the end of either window. The licensed feeds are never held in a shared cache: a shared cache keys on the URL rather than on the key header, so a cached licensed body would be reachable without a key. They serve private, max-age=300 and Vary: x-cebe-key, which caches in the caller's own client and nowhere else, and they keep their ETag. Behind the cache, requests are rate-limited to 100 per minute per IP; over-limit requests receive 429 with Retry-After: 60. Error responses are never cached. If upstream garbage rows were stripped server-side, the response carries an X-CEBE-Integrity header and caches for 60 seconds so a cleanup propagates fast.

Versioning contract

The v1 response shape is a published contract: additive changes only. Fields are never renamed or removed. New fields may appear at any time, so parse tolerantly.

Embed images

Dated figure cards, 1200×630 PNG, for a post, a slide, or a page that wants the figures without calling the JSON feed and drawing its own chart. No key, no registration, and hot-linking is the intended use.

The two routes

https://cebetracker.io/embed/MSTR/2026-09-30.png    one company, at the close for that date
https://cebetracker.io/embed/fleet/2026-09-30.png   every live company, at that one close

Every card carries the company, CEBE sats per basic share, Senior Claims %, the date of the snapshot the figures were read from, the Bitcoin close they were struck at, and the rules version they were computed under. The fleet strip carries one row per live company. The ticker accepts any alias the site accepts, in upper or lower case.

Cards are dated only. There is no undated card that moves with the live price: a figure on an image travels away from its page, so it carries its own date and price on its face or it does not ship.

What a dated card states

The close for a date is the /api/btc-close print for that date, the 00:00 UTC print of the following day. Each company is read from its latest snapshot filed on or before the date, computed through the same rules file as this feed at that one close, so every row on a fleet card shares one price. A date whose close has not been struck yet is refused rather than served as a partial day. CEBE mNAV is not on the cards, because it needs a stock price on the date and the site has no dated stock close to strike it with.

Where the snapshot a card reads is the one this feed serves, the card checks it against the feed first: at its own btc_price the row must reproduce cebe_sats and senior_claims_pct exactly, or the card withholds the company with that reason. A company with a required field missing reads Not yet verified with the field named, never a blank, because a blank on an image reads as a zero.

<a href="https://cebetracker.io/company/MSTR/">
  <img src="https://cebetracker.io/embed/MSTR/2026-09-30.png"
       width="1200" height="630"
       alt="Strategy (MSTR): CEBE sats per basic share and Senior Claims % at the 2026-09-30 close, from CEBE Tracker">
</a>
<p>Data via <a href="https://cebetracker.io">CEBE Tracker, cebetracker.io</a></p>

Markdown, for a README or anywhere that takes it:

[![CEBE for MSTR](https://cebetracker.io/embed/MSTR/2026-09-30.png)](https://cebetracker.io/company/MSTR/)

Caching and failures

A card is cached for up to an hour and refreshed after each update to the data. If a source the card reads is unavailable, the last card drawn for that URL is served in its place. A request with no date, or with no ticker on the company route, is answered 400; a date whose close has not been struck, or a ticker outside the live universe, is answered 404. A card that cannot be drawn still returns an image saying what failed, never a broken-image icon, and those responses are never cached.

These are not social card images, and nothing on the site points og:image at them.

Terms of Use

Dated 11 September 2026. These terms may evolve; see Changes.

The CEBE Tracker service and its content are operated by Tierney Analytics LLC.

The companies feed, /api/v1/companies.json, and the computed figures it serves are free to use with attribution, with no key, no registration and no fee. The history, instruments and deals feeds are licensed integrations, available by API key at CEBE Tracker's discretion.

Commercial use

Commercial use of the API is permitted under these attribution terms; CEBE Tracker reserves the right to introduce commercial licensing tiers for systematic or revenue-bearing redistribution, with existing implementers grandfathered on notice.

Attribution

Cite the source in this form:

Data via CEBE Tracker, cebetracker.io

Render cebetracker.io as a link to https://cebetracker.io wherever the medium supports links. The citation belongs on any surface that displays the data, in view alongside the figures themselves. A chart, a table, a slide, a post, or a screenshot each carries its own citation. A footnote, an endnote, a credits page, or a source list elsewhere in the document does not satisfy this.

The embed images carry the citation on the card itself, so an image posted on its own is already attributed. A link to cebetracker.io beside it is still the better form wherever the medium supports one.

No representation as house data

Do not present these figures as your own original or in-house research, and do not republish the dataset under another name or brand as though it were independently produced. Work derived from the feed is welcome, and the underlying figures stay attributed to CEBE Tracker.

Naming the measure

A figure computed on the CEBE construction, total bitcoin less Net Senior Claims in bitcoin as defined on the methodology page, divided by basic shares outstanding, at any dated bitcoin price, is CEBE. Label it CEBE wherever it is displayed, alongside any other name you also give it. A figure that changes any part of that construction, including the share count, the claims included, or their netting, is not CEBE. Do not label it CEBE, and state what was changed where the figure appears.

No endorsement in either direction

Use of this data does not mean CEBE Tracker endorses you, your product, or your analysis, and it does not mean you endorse CEBE Tracker. Do not describe the relationship as a partnership, an affiliation, a sponsorship, or a review, and do not use the CEBE Tracker name or wordmark in a way that suggests one.

Publishing the figures accurately

Every figure traces to a primary filing; the per-company source field carries the reference. Every CEBE figure is a function of a dated BTC price, so publish the basis (snapshot or live) and the as_of date alongside any number you take from the feed.

Changes

These terms may evolve as the feed does. Each revision changes the date at the top of this section and the terms_date field in every feed response. A revision takes effect 30 days after that date. Continuing to call the feed after a revision takes effect means accepting the revised terms, and a live product that calls the feed is continuing use. Static work published before a revision takes effect, such as a post, chart, screenshot or article, stays governed by the version in force when it was published.

2026-09-16: undocumented row-level notes fields were removed from the deals and instruments feeds. They carried internal working notes and were never part of the documented field tables. No documented field changed. The 30-day change clock applies from this date.

Access

Access to the feed is provided at CEBE Tracker's discretion. Use that does not meet these terms is outside this permission, and access for that use may be withdrawn.