# Glassnode Lightning Network Gini Coefficient (Capacity Distribution)

> Glassnode Lightning Network Gini Coefficient (Capacity Distribution) 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 Gini coefficient measuring how Bitcoin capacity is distributed across Lightning Network nodes, indicating centralization levels.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/lightning/gini_capacity_distribution
- 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-lightning-network-gini-coefficient-capacity-distribution-64af96ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MVXK4wU6tRIkHihlYppRX

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-lightning-network-gini-coefficient-capacity-distribution-64af96ac
```

Example prompt: Pull the latest Glassnode Lightning Network Gini coefficient for BTC capacity distribution in JSON format so I can see how centralized node capacity currently is.

## When to prefer this

Use this endpoint when you need to quantitatively measure how concentrated or decentralized Bitcoin capacity is on the Lightning Network. Prefer this over generic Lightning stats when specifically interested in inequality/centralization metrics (Gini-based). Best for macro analysis of Lightning Network health and decentralization trends over time.

## Known failure modes

- Missing required 'a' parameter (asset symbol) returns a 400 error
- Invalid asset symbol (non-BTC) rejected due to enum constraint
- Payment not completed results in 402 Payment Required
- Upstream Glassnode data unavailable returns 503 or empty result
- Invalid interval value returns 400 bad request

## How this service works

Lightning Network Gini Coefficient (Capacity Distribution) — Lightning Network Gini Coefficient (Capacity Distribution) is a statistical measure of how Bitcoin capacity is distributed across nodes on the Lightning Network, used to monitor the degree of centralization and the potential risks associated with highly concentrated capacity. Data by Glassnode.

## Output

Returns a time-series array of objects, each with a Unix timestamp ('t') and the Gini coefficient value ('v') representing the degree of inequality in Lightning Network capacity distribution across nodes, where 0 is perfect equality and 1 is maximum concentration.

## 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": {
       "t": {
        "type": "number"
       },
       "v": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-lightning-network-gini-coefficient-capacity-distribution-64af96ac/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)