# Glassnode Relative Unrealized Profit (x402)

> Glassnode Relative Unrealized Profit (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 Profit metric for a crypto asset — the aggregate paper gain held by coin holders whose acquisition price is below current spot, normalized by market cap.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/indicators/unrealized_profit
- 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-profit-x402-28529a3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i-ZRJ_3zjaRC_YOoJh5IU

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-profit-x402-28529a3c
```

Example prompt: Pull the latest Glassnode Relative Unrealized Profit data for BTC in JSON format so I can see how much paper gain the market is sitting on right now.

## When to prefer this

Use this endpoint when you need on-chain profitability sentiment for Bitcoin or Ethereum specifically normalized by market cap (relative, not absolute), as opposed to raw NUPL or total unrealized profit in USD. Ideal for macro market cycle analysis and identifying overheated or undervalued market conditions based on holder behavior.

## Known failure modes

- Missing required 'a' (asset) query parameter returns a 400 error
- Unsupported asset symbol returns an error or empty dataset
- Payment not included or insufficient USDC results in HTTP 402 Payment Required
- Invalid interval or format enum value returns a 400 validation error
- Network or upstream Glassnode data unavailability returns a 503 or timeout

## How this service works

Relative Unrealized Profit — Relative Unrealized Profit is the aggregate USD paper gain carried by all coins whose price at realisation time was lower than the current spot price, normalized by market cap. Data by Glassnode.

## Output

An array of timestamped data points where each entry contains a Unix timestamp (t) and the relative unrealized profit value (v) — a floating-point ratio representing aggregate paper gains normalized by market cap for the queried asset.

## 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-profit-x402-28529a3c/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)