# CoinBucha Sovereign Bitcoin Snapshots

> CoinBucha Sovereign Bitcoin Snapshots is a paid API for AI agents from coinbucha.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-30).

Returns a complete frozen monthly snapshot history of national/sovereign Bitcoin holdings with cited sources in a single API call.

## Facts

- Endpoint: GET https://coinbucha.com/api/paid/sovereign-snapshots?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinbucha-sovereign-bitcoin-snapshots-fc79712e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2jAXnBouD5AXmhHYpHU0B

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 coinbucha-sovereign-bitcoin-snapshots-fc79712e
```

Example prompt: Pull the full history of every country's official Bitcoin holdings — all the monthly frozen snapshots with sources — so I can see how national reserves have evolved over time.

## When to prefer this

Choose this endpoint when you need a comprehensive, historically complete, sourced record of nation-state Bitcoin holdings in a single call — particularly useful for macro research, geopolitical analysis, or benchmarking sovereign crypto reserve trends over time. Prefer it over general news or web search when you need structured, citable data rather than narrative coverage.

## Known failure modes

- Payment not processed — returns 402 if USDC payment header is missing or insufficient
- No data available for a given period if sovereign holdings data is not yet compiled
- Rate limiting or access denied if the API key or payment is invalid
- Incomplete source citations if underlying national data is not publicly reported

## How this service works

Which countries hold bitcoin? Every frozen monthly snapshot of national (sovereign) bitcoin reserves by country, with sources, in one call. Not investment advice.

## Output

A structured dataset containing every frozen monthly snapshot of sovereign/national Bitcoin holdings across all tracked countries, including the volume of BTC held, the snapshot date, and the cited sources for each data point.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinbucha-sovereign-bitcoin-snapshots-fc79712e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coinbucha.com](https://www.zero.xyz/host/coinbucha.com/llms.txt)