# Glassnode Metrics Catalog

> Glassnode Metrics Catalog is a paid API for AI agents from x402.glassnode.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Lists all available on-chain and market metric paths from Glassnode, optionally filtered by asset, exchange, interval, or currency.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metadata/metrics
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glassnode-metrics-catalog-4e4d4f52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__HQF4rPaedbv9_cOjP5bs

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-metrics-catalog-4e4d4f52
```

Example prompt: What Glassnode on-chain metrics are available for Bitcoin at a 24h interval in USD? Show me the full catalog filtered to those parameters.

## When to prefer this

Use this endpoint first to discover which metric paths and parameter combinations are supported before querying actual Glassnode metric data. Prefer this over guessing metric path names or hardcoding paths that may not exist for a given asset/interval/exchange combination.

## Known failure modes

- Invalid asset symbol returns empty or error response
- Unsupported interval value yields no matching metrics
- Payment of 0.01 USDC not processed results in 402 error
- Unknown exchange name returns empty catalog
- Malformed query parameter types cause 400 validation error

## How this service works

Metrics Catalog — Lists all available metric paths. Use the optional filter parameters (asset, exchange, interval, currency, etc.) to narrow the catalog to metrics that support a given combination. Data by Glassnode.

## Output

A catalog of available Glassnode metric paths that match the supplied filter criteria (asset, exchange, interval, currency). Each entry identifies a metric path that can be used to query actual data from sibling endpoints.

## 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",
     "properties": {
      "a": {
       "type": "string",
       "description": "Asset id, e.g. BTC, ETH"
      },
      "c": {
       "type": "string",
       "description": "Currency for values, e.g. native, usd"
      },
      "e": {
       "type": "string",
       "description": "Exchange name, e.g. binance, coinbase"
      },
      "i": {
       "type": "string",
       "description": "Time interval / resolution, e.g. 1h, 24h"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-metrics-catalog-4e4d4f52/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)
