# Glassnode Relative Address Supply Distribution

> Glassnode Relative Address Supply Distribution 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 share of circulating crypto supply held by addresses in each balance band, normalized as percentages

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/addresses/supply_distribution_relative
- 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-relative-address-supply-distribution-dc588f45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aD70yKiAI4flnTRcmSjGQ

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-relative-address-supply-distribution-dc588f45
```

Example prompt: Show me the relative address supply distribution for BTC on Glassnode — I want to see what share of circulating supply each balance band holds, with daily resolution and JSON format.

## When to prefer this

Use this endpoint when you need on-chain supply concentration data broken down by address balance bands expressed as relative (percentage) shares of circulating supply, rather than absolute coin amounts. Prefer this over absolute supply distribution when comparing wealth concentration across assets or time periods where normalization is important.

## Known failure modes

- Missing required asset symbol 'a' parameter returns 400 error
- Unsupported asset or network combination returns empty or error response
- Payment of 0.05 USDC not fulfilled results in 402 Payment Required
- Invalid interval or format enum value returns validation error
- Rate limiting or quota exceeded returns 429 error

## How this service works

Relative Address Supply Distribution — Relative Address Supply Distribution reports the share of circulating supply held by addresses falling within each balance band. Data by Glassnode.

## Output

An array of timestamped data points where each entry contains an object with supply share percentages for each balance band (e.g. addresses holding <0.001 BTC, 0.001–0.01 BTC, etc.), expressed as fractions of total circulating supply.

## 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": [
        "1month",
        "1w",
        "24h"
       ],
       "type": "string",
       "description": "Time interval / resolution, e.g. 24h, 1w, 1month"
      },
      "network": {
       "enum": [
        "aggregated",
        "arb",
        "base",
        "eth",
        "opt"
       ],
       "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-relative-address-supply-distribution-dc588f45/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)