# Glassnode Metric Metadata

> Glassnode Metric Metadata 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).

Returns metadata for a single on-chain metric including supported parameters, allowed values, available time range, documentation links, and descriptors like name, group, and tags.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metadata/metric
- 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-metric-metadata-b6a7c3de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ePoLfHzi41xkgxjjoU1Hy

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-metric-metadata-b6a7c3de
```

Example prompt: What parameters and allowed values does the Glassnode metric at path /addresses/active/count support — specifically what time intervals and assets are available?

## When to prefer this

Use this endpoint when you need to discover what parameters, resolutions, assets, or date ranges are valid for a specific Glassnode metric before querying it for data. Ideal for dynamic agent workflows that need to enumerate options or validate inputs before making a data call.

## Known failure modes

- Missing required 'path' query parameter returns an error
- Invalid or non-existent metric path returns a 404 or empty result
- Payment failure (insufficient USDC balance) returns HTTP 402
- Rate limiting or authentication failure returns 4xx error

## How this service works

Metric Metadata — Returns metadata for a single metric: its supported parameters and allowed values, available time range, documentation and Studio links, and descriptors such as name, group, and tags. Requires the path parameter. Data by Glassnode.

## Output

A metadata object for the specified metric including: its human-readable name, group classification, tags, all supported query parameters (asset, currency, exchange, interval) with their allowed values, the earliest and latest available timestamps, and links to official documentation and Glassnode Studio.

## 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": [
      "path"
     ],
     "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"
      },
      "path": {
       "type": "string",
       "description": "Metric path, e.g. /addresses/count"
      }
     }
    }
   },
   "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-metric-metadata-b6a7c3de/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)