# Glassnode Difficulty Ribbon

> Glassnode Difficulty Ribbon 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 Bitcoin mining difficulty ribbon data composed of seven SMAs (200d, 128d, 90d, 60d, 40d, 25d, 14d) stacked as a ribbon indicator

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/indicators/difficulty_ribbon
- 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-difficulty-ribbon-acb9760d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__02zKqOTiIVSJQH2a-x3P

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-difficulty-ribbon-acb9760d
```

Example prompt: Can you pull the Bitcoin difficulty ribbon data from Glassnode in JSON format so I can see how the 14-day through 200-day mining difficulty moving averages are stacked right now?

## When to prefer this

Use this endpoint when you need Bitcoin mining difficulty ribbon data specifically — combining multiple SMAs into a composite ribbon view — especially for assessing miner stress, capitulation signals, or difficulty trend compression. Prefer this over raw price or hash rate endpoints when the analytical goal is understanding miner economics over time.

## Known failure modes

- Missing required 'a' query parameter (asset symbol) returns a 400 error
- Invalid asset symbol other than BTC returns an error since only BTC is supported
- Payment not provided or insufficient USDC balance triggers a 402 Payment Required response
- Requesting unsupported intervals or formats returns a validation error
- Network timeout or upstream Glassnode data unavailability returns 503

## How this service works

Difficulty Ribbon — Difficulty Ribbon is an indicator built from seven simple moving averages (200d, 128d, 90d, 60d, 40d, 25d, 14d) of Bitcoin mining difficulty, stacked as a ribbon. Data by Glassnode.

## Output

An array of timestamped objects, each containing an object with the seven simple moving average values of Bitcoin mining difficulty (200d, 128d, 90d, 60d, 40d, 25d, 14d) representing the ribbon at daily resolution.

## 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": {
       "enum": [
        "BTC"
       ],
       "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": {
       "o": {
        "type": "object"
       },
       "t": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-difficulty-ribbon-acb9760d/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)