# 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.02/call, status unknown (last checked 2026-10-12).

Returns SEC-sourced Bitcoin holdings data (BTC held, shares outstanding, sats per share) for major Bitcoin treasury companies including MSTR, MARA, RIOT, XXI, and Metaplanet.

## Facts

- Endpoint: GET https://btc-treasury-worker.stackstats.workers.dev/snapshot?utm_source=zero.xyz
- Price: $0.02/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-9df1f237
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N5_TkgzqmKho4E8ezo7_d

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-9df1f237
```

Example prompt: Pull the latest SEC-sourced Bitcoin treasury snapshot showing BTC holdings, shares outstanding, and sats per share for MSTR, MARA, RIOT, XXI, and Metaplanet.

## When to prefer this

Choose this endpoint when you need factual, SEC-sourced Bitcoin holdings data for major public Bitcoin treasury companies without price data — ideal for share-level BTC exposure analysis, compliance-focused research, or building dashboards that require audit-trail sourcing. Prefer over general crypto data APIs when SEC filing provenance and sats-per-share metrics are required.

## Known failure modes

- Stale data if SEC filings have not been updated since last offline computation
- Missing or null entries for companies that haven't filed recently
- Network timeout if Cloudflare Worker is unavailable
- Payment failure if x402 micropayment of $0.02 USDC is not correctly handled

## 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 an array of rows, each with ticker, company name, BTC holdings amount, shares outstanding (with basis notes), sats per share, SEC source URL, source filing type, and the date holdings were reported. Also includes a timestamp, snapshot generation time, disclaimer, and confirmation that no price data was used.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "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",
  "price_data_used": "none",
  "snapshot_generated_at": "2026-10-11T03:34:21.030Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/btc-treasury-snapshot-9df1f237/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)