# Glassnode Velocity Metric

> Glassnode Velocity 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 velocity of a cryptocurrency asset, measuring how quickly units are circulating in the network over time.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/indicators/velocity
- 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-velocity-metric-db32577d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NY37mWBzcqRHcqwHxap9y

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-velocity-metric-db32577d
```

Example prompt: Pull the Glassnode on-chain velocity metric for BTC over 24h intervals in JSON format — I want to see how quickly coins are circulating in the network right now.

## When to prefer this

Use this endpoint when you need on-chain velocity data specifically from Glassnode for Bitcoin or Ethereum, particularly when building dashboards, monitoring coin circulation trends, or conducting blockchain economic analysis. Prefer this over general market data APIs when you specifically need the velocity indicator measuring the ratio of on-chain transaction volume to supply.

## Known failure modes

- Missing required asset symbol 'a' parameter returns a 400 error
- Unsupported asset symbol returns empty data or error
- Invalid interval or format enum value returns a 400 validation error
- Insufficient USDC payment (below $0.05) results in 402 Payment Required
- Network connectivity issues or upstream Glassnode outage return 5xx errors

## How this service works

Velocity — Velocity measures how quickly units are circulating in the network. Data by Glassnode.

## Output

An array of timestamped data points, each containing a Unix timestamp (t) and a velocity value (v), showing how quickly the asset's units are circulating in the network over the requested time interval.

## 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"
      },
      "network": {
       "enum": [
        "aggregated",
        "arb",
        "base",
        "eth",
        "opt"
       ],
       "type": "string",
       "description": "Network / blockchain identifier for cross-chain metrics"
      }
     }
    }
   },
   "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-velocity-metric-db32577d/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)