# Glassnode HODL Waves

> Glassnode HODL Waves 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 the HODL Waves supply age band distribution, showing what percentage of Bitcoin supply was last moved within each time period, summing to 100% per day.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/supply/hodl_waves
- 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-hodl-waves-d01032dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cfzKn7CHwSJeiEzogfib0

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-hodl-waves-d01032dc
```

Example prompt: Pull the latest Glassnode HODL Waves data for BTC in JSON format so I can see how the Bitcoin supply is distributed across different holding age bands.

## When to prefer this

Use this endpoint when you need to analyze the age distribution of Bitcoin (or supported asset) supply over time, understand long-term vs short-term holder behavior, detect accumulation or distribution trends via coin age bands, or replicate the classic Glassnode HODL Waves visualization. Prefer this over simple price or volume endpoints when on-chain behavioral analysis of holder cohorts is the goal.

## Known failure modes

- Missing required 'a' (asset) parameter returns 400 error
- Unsupported asset symbol returns empty or error response
- Payment not processed via x402 protocol returns 402 Payment Required
- Invalid 'i' interval value (only '24h' supported) returns validation error
- Network parameter incompatible with BTC asset may return empty data
- Rate limiting or payment failure returns 402 or 429 status

## How this service works

HODL Waves — A bundle of all active supply age bands. Each colored band shows the percentage of supply in existence that was last moved within the time period denoted in the legend, so every vertical slice sums to 100%. Data by Glassnode.

## Output

An array of timestamped objects, each containing an object with fractional supply values for each HODL wave age band (e.g. 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-12m, 1y-2y, 2y-3y, 3y-5y, 5y+), representing what percentage of the total supply was last moved within that time window. Each vertical slice across all bands sums to 100%.

## 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": {
       "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"
      },
      "network": {
       "enum": [
        "aggregated",
        "arb",
        "base",
        "eth",
        "opt",
        "sol",
        "ton",
        "trx"
       ],
       "type": "string",
       "description": "Network / blockchain identifier for cross-chain metrics"
      }
     }
    }
   },
   "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-hodl-waves-d01032dc/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)