# Glassnode Bitcoin Supply by TxOut Type

> Glassnode Bitcoin Supply by TxOut Type is a paid API for AI agents from x402.glassnode.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a time-series breakdown of total Bitcoin supply distributed across output script types: P2TR, P2WPKH, P2WSH, P2SH, P2PKH, P2PK, and Other.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/supply/supply_by_txout_type
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glassnode-bitcoin-supply-by-txout-type-55ae3387
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6DeBK86I-q4m0aTrhI13d

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 glassnode-bitcoin-supply-by-txout-type-55ae3387
```

Example prompt: Pull the Glassnode data on how Bitcoin's total supply is distributed across output script types — P2TR, SegWit, P2SH, P2PKH and the rest — for BTC in native units at daily resolution.

## When to prefer this

Use this endpoint when you need a historical time-series breakdown of Bitcoin supply distribution across UTXO script types, particularly to analyze Taproot adoption, SegWit migration trends, or legacy address usage. Prefer this over general UTXO count endpoints when you need supply-weighted (amount of BTC) rather than count-based analysis.

## Known failure modes

- Missing required 'a' query parameter (asset symbol) returns a 400 error
- Invalid asset symbol (non-BTC) returns a 400 or 422 error
- Payment not provided or insufficient USDC causes a 402 Payment Required response
- Rate limiting or quota exhaustion returns a 429 error
- Server-side data unavailability returns a 503 error

## How this service works

Supply by TxOut Type — A breakdown of total Bitcoin supply by output script (locking) type. Types include P2TR (Taproot), the SegWit types P2WPKH and P2WSH, P2SH (arbitrary scripts), P2PKH and P2PK (public-key based), and Other as a catch-all for outputs that do not match the most common types. Data by Glassnode.

## Output

A time-series array of objects, each with a Unix timestamp and a nested object containing the Bitcoin supply (in BTC or USD depending on currency parameter) held in each output script type: P2TR, P2WPKH, P2WSH, P2SH, P2PKH, P2PK, and Other.

## 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",
     "required": [
      "a"
     ],
     "properties": {
      "a": {
       "enum": [
        "BTC"
       ],
       "type": "string",
       "description": "Asset symbol, e.g. BTC, ETH"
      },
      "c": {
       "enum": [
        "native"
       ],
       "type": "string",
       "description": "Currency for denominated values, e.g. usd, native"
      },
      "f": {
       "enum": [
        "csv",
        "json"
       ],
       "type": "string",
       "description": "Response format: json or csv"
      },
      "i": {
       "enum": [
        "24h"
       ],
       "type": "string",
       "description": "Time interval / resolution, e.g. 24h, 1w, 1month"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "o": {
        "type": "object"
       },
       "t": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-bitcoin-supply-by-txout-type-55ae3387/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.glassnode.com](https://www.zero.xyz/host/x402.glassnode.com/llms.txt)