# Glassnode Circulating Supply Metric

> Glassnode Circulating Supply Metric 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 total circulating supply of a cryptocurrency asset (e.g. BTC, ETH) at configurable time intervals via Glassnode's on-chain data.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/supply/current
- 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-circulating-supply-metric-c83d1b5f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_souFaFYNyzhXZJ12Ktfb2

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-circulating-supply-metric-c83d1b5f
```

Example prompt: What's the current circulating supply of Bitcoin in native units? Fetch the daily 24h resolution data from Glassnode.

## When to prefer this

Use this endpoint when you need authoritative on-chain circulating supply data for a cryptocurrency from Glassnode, especially when building financial dashboards, performing market analysis, or monitoring supply inflation over time. Prefer this over exchange APIs when you want verified on-chain data rather than exchange-reported figures.

## Known failure modes

- Missing required 'a' (asset symbol) parameter returns a 400 error
- Unsupported asset symbol returns an error or empty result
- Invalid interval enum value ('i') causes a bad request
- Payment not processed results in 402 Payment Required
- Rate limiting or quota exhaustion returns a 429 error

## How this service works

Circulating Supply — The total amount of all coins ever created or issued, i.e. the circulating supply. Data by Glassnode.

## Output

An array of objects each containing a Unix timestamp (t) and the circulating supply value (v) for the requested asset and interval. Values can be returned in native coin units or USD depending on the 'c' parameter, and in JSON or CSV format.

## 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",
        "usd"
       ],
       "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": [
        "1month",
        "1w",
        "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-circulating-supply-metric-c83d1b5f/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)