# Glassnode Exchange Balance (Total)

> Glassnode Exchange Balance (Total) 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 amount of a cryptocurrency held on all exchange addresses, as tracked by Glassnode on-chain analytics.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/distribution/balance_exchanges
- 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-exchange-balance-total-4c37dbe4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dHhv8OEdN8v7AyHhzUrpk

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-exchange-balance-total-4c37dbe4
```

Example prompt: What's the total amount of BTC currently held on all crypto exchanges according to Glassnode — give me the latest daily figure in native BTC units?

## When to prefer this

Use this endpoint when you need on-chain exchange balance data sourced from Glassnode — the leading provider of blockchain analytics — specifically to understand how much of a cryptocurrency is held on exchange addresses. Prefer this over generic price APIs when you need market structure insights like exchange reserve trends, potential sell pressure, or accumulation signals.

## Known failure modes

- Missing required asset symbol 'a' parameter returns 400 error
- Invalid or unsupported asset symbol returns error or empty data
- Insufficient USDC payment (requires $0.05) returns 402 Payment Required
- Unsupported network/asset combination returns error
- Rate limiting or payment failure may return 429 or 402 status

## How this service works

Balance on Exchanges (Total) — The total amount of coins held on exchange addresses. Data by Glassnode.

## Output

Returns an array of time-series data points, each containing a Unix timestamp (t) and the total balance value (v) representing the amount of the specified cryptocurrency held across exchange addresses. The currency can be in native units or USD depending on the 'c' parameter.

## 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"
      },
      "e": {
       "type": "string",
       "description": "Exchange name, e.g. binance, coinbase"
      },
      "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-exchange-balance-total-4c37dbe4/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)