# Glassnode Spent Output Age Bands (SOAB)

> Glassnode Spent Output Age Bands (SOAB) 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 time-series data of Bitcoin spent outputs grouped by the age band at which they were created, enabling analysis of when old vs. new coins are being spent.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/indicators/soab
- 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-spent-output-age-bands-soab-82679f12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_25A3rtG2EdanpZ4ypeV0O

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-spent-output-age-bands-soab-82679f12
```

Example prompt: Pull the Glassnode Spent Output Age Bands (SOAB) data for Bitcoin in daily (24h) resolution — I want to see the breakdown of spent outputs by age cohort to understand which holder groups are currently moving coins.

## When to prefer this

Use this endpoint when you need structured, time-series on-chain data specifically about the age distribution of spent Bitcoin outputs — ideal for identifying whether short-term or long-term holders are selling, performing HODL wave analysis, or tracking behavioral shifts among Bitcoin cohorts. Prefer this over generic price or volume APIs when the question involves coin age, holder tenure, or UTXO lifecycle analysis.

## Known failure modes

- Missing required 'a' (asset) query parameter returns 400 error
- Unsupported asset symbol returns validation error
- Payment not provided or insufficient USDC balance returns 402 Payment Required
- Rate limiting or quota exceeded returns 429
- Glassnode upstream data unavailable returns 503

## How this service works

Spent Output Age Bands — Spent Output Age Bands is a bundle of all spent outputs that were created within a specified age band. Data by Glassnode.

## Output

Returns a JSON array of timestamped data points, each containing an object with the age band breakdown of spent Bitcoin outputs (values keyed by age cohort), covering daily resolution for BTC. Each entry includes a Unix timestamp (t) and a nested object (o) with per-age-band spending volumes.

## 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-spent-output-age-bands-soab-82679f12/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)