# BTC Treasury Snapshot

> BTC Treasury Snapshot is a paid API for AI agents from btc-treasury-worker.stackstats.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns SEC-sourced Bitcoin holdings data (BTC held, shares outstanding, sats per share, filing source and date) for major Bitcoin treasury companies by ticker symbol.

## Facts

- Endpoint: GET https://btc-treasury-worker.stackstats.workers.dev/company/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/btc-treasury-snapshot-45333e04
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YLsCxGmv5svPMets2OLIN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability btc-treasury-snapshot-45333e04
```

Example prompt: Pull up the latest SEC-sourced Bitcoin treasury snapshot for MSTR — I want to see their BTC holdings, shares outstanding, and sats per share.

## When to prefer this

Use this endpoint when you need factual, SEC-sourced Bitcoin treasury data for publicly traded Bitcoin treasury companies (MSTR, MARA, RIOT, XXI, Metaplanet) without price data or investment signals. Prefer it over generic financial data APIs when you specifically need sats-per-share derived metrics and direct SEC filing provenance.

## Known failure modes

- Unsupported ticker symbol returns an error or empty result — only MSTR, MARA, RIOT, XXI, and Metaplanet are supported
- Data may lag behind very recent SEC filings if the snapshot has not been updated
- Shares outstanding may exclude recent ATM issuances as noted in the shares_basis field
- Cloudflare Worker downtime could cause 5xx errors

## How this service works

Bitcoin treasury companies BTC holdings per share, SEC-sourced: MSTR, MARA, RIOT, XXI, Metaplanet. BTC held, shares outstanding, sats per share, filing source + date. No price data. Factual only, not investment advice.

## Output

A JSON object containing the company name, ticker, total BTC holdings, shares outstanding, sats per share (derived metric), the SEC filing type and source URL, the date holdings were reported, shares basis notes, snapshot generation timestamp, and a disclaimer that the data is not investment advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "row": {
   "note": null,
   "ticker": "MSTR",
   "company": "Strategy Inc",
   "source_url": "https://www.sec.gov/Archives/edgar/data/1050446/000119312526413164/mstr-20261005.htm",
   "source_date": "2026-10-05",
   "btc_holdings": 848000,
   "shares_basis": "364,585,501 Class A + 19,640,250 Class B as of 2026-07-24 (10-Q cover); excludes later ATM issuance",
   "source_filing": "SEC Form 8-K",
   "holdings_as_of": "2026-10-04",
   "sats_per_share": 220703.6,
   "shares_source_url": "https://www.sec.gov/Archives/edgar/data/1050446/000105044626000044/mstr-20260630.htm",
   "shares_outstanding": 384225751
  },
  "source": "SEC filings / company disclosures; derived metrics computed offline",
  "timestamp": "2026-10-11T03:34:21.030Z",
  "disclaimer": "not investment advice",
  "snapshot_generated_at": "2026-10-11T03:34:21.030Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/btc-treasury-snapshot-45333e04/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from btc-treasury-worker.stackstats.workers.dev](https://www.zero.xyz/host/btc-treasury-worker.stackstats.workers.dev/llms.txt)