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

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

## Facts

- Endpoint: GET https://btc-treasury-worker.stackstats.workers.dev/verdict/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.005/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-23fe072f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZQk1lTzJ6t0VZH9_EhGNy

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-23fe072f
```

Example prompt: What are MicroStrategy's current Bitcoin holdings per share — give me the sats per share figure and the SEC filing it came from.

## When to prefer this

Choose this endpoint when you need factual, SEC-sourced BTC holdings and sats-per-share data for the major publicly traded Bitcoin treasury companies (MSTR, MARA, RIOT, XXI, Metaplanet) without price data. It is ideal for due diligence, research, or portfolio monitoring workflows where citation of a specific SEC filing and date is required. Prefer alternatives if you need real-time BTC price, market cap, or holdings for companies outside this supported set.

## Known failure modes

- Unsupported ticker symbol returns an error or empty response — only MSTR, MARA, RIOT, XXI, and Metaplanet are supported
- Stale snapshot if the underlying SEC filing has not been reprocessed since a new disclosure
- Payment failure (x402) if the $0.005 USDC microtransaction is not properly authorized
- Network timeout from Cloudflare Worker under high load

## 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 ticker, a plain-English statement of BTC held and sats per share, shares outstanding, filing source and date, snapshot timestamp, and a disclaimer that this is factual data only and not investment advice.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "SEC filings / company disclosures; derived metrics computed offline",
  "ticker": "MSTR",
  "statement": "Strategy Inc holds 220,703.6 sats/share (848,000 BTC / 384,225,751 shares) as of 2026-10-04, per SEC Form 8-K dated 2026-10-05. Factual only, not investment advice.",
  "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-23fe072f/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)