# Glassnode Relative Unrealized Loss (x402)

> Glassnode Relative Unrealized Loss (x402) 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 Relative Unrealized Loss metric for a crypto asset — the total USD loss of all coins whose realization price was higher than the current price, normalized by market cap.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/indicators/unrealized_loss
- 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-relative-unrealized-loss-x402-74f69ff8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VUEfSflmxDp4s1n32PAKe

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-unrealized-loss-x402-74f69ff8
```

Example prompt: Pull the latest Glassnode relative unrealized loss data for BTC in JSON format so I can see how much of the market cap is currently underwater.

## When to prefer this

Use this endpoint when you need a normalized, market-cap-adjusted view of unrealized losses across all holders of a crypto asset — useful for gauging market stress, capitulation risk, or sentiment without raw USD magnitudes that scale with market size. Prefer over absolute unrealized loss metrics when comparing across different market cap regimes or assets.

## Known failure modes

- Missing required 'a' (asset) query parameter returns a 400 error
- Unsupported asset symbol returns an empty dataset or error
- Payment not made or invalid x402 payment header returns 402 Payment Required
- Unsupported interval or format enum value returns 400
- Rate limiting or quota exhaustion returns 429

## How this service works

Relative Unrealized Loss — Relative Unrealized Loss is the total USD loss of all coins in existence whose price at realisation time was higher than the current price, normalized by market cap. Data by Glassnode.

## Output

A JSON (or CSV) array of timestamped data points, each with a Unix timestamp ('t') and the corresponding relative unrealized loss value ('v') — a normalized ratio between 0 and 1 representing underwater market cap exposure.

## 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-relative-unrealized-loss-x402-74f69ff8/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)