# Glassnode Holder Accumulation Ratio

> Glassnode Holder Accumulation Ratio 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-14).

Returns the proportion of active crypto holders who increased their balance versus those who decreased it, over 24h intervals

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/addresses/holder_accumulation_ratio
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glassnode-holder-accumulation-ratio-79857038
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XcmhNCWPta0WDwFpQtGPQ

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-holder-accumulation-ratio-79857038
```

Example prompt: What's the current Glassnode holder accumulation ratio for BTC — are more holders adding to their positions or reducing them?

## When to prefer this

Use this endpoint when you need precise on-chain data about whether crypto holders are in accumulation or distribution mode, specifically the ratio of holders increasing vs decreasing balances. Prefer this over generic sentiment APIs when you want quantitative, wallet-level behavioral data rather than social or price-based sentiment. Best suited for 24h granularity analyses of BTC, ETH, or other major assets supported by Glassnode.

## Known failure modes

- Missing required 'a' (asset) parameter returns a 400 error
- Unsupported asset symbol returns an error or empty data
- Payment not included or insufficient USDC results in 402 Payment Required
- Invalid format enum value (not 'json' or 'csv') returns a 400 error
- Invalid interval (not '24h') returns a 400 error
- Rate limiting or server errors return 5xx responses

## How this service works

Holder Accumulation Ratio — Holder Accumulation Ratio is the proportion of active holders who are increasing their positions versus those decreasing them, focusing exclusively on holders who changed their balance. It is calculated by dividing the number of holders who increased their balance by the total number of holders who changed their balance in either direction. Data by Glassnode.

## Output

A time-series array of objects each containing a Unix timestamp (t) and the accumulation ratio value (v), where the ratio is the number of holders who increased their balance divided by total holders who changed their balance, expressed as a proportion between 0 and 1.

## 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"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "t": {
        "type": "number"
       },
       "v": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-holder-accumulation-ratio-79857038/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)