# Glassnode US Spot ETF Balances (All)

> Glassnode US Spot ETF Balances (All) 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 most recent holdings of major U.S.-listed spot Bitcoin and Ethereum ETFs (e.g. IBIT, GBTC, FBTC, ETHA) by issuer, denominated in native or USD, at daily/weekly/monthly resolution.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/institutions/us_spot_etf_balances_all
- 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-us-spot-etf-balances-all-dfce9fc2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dII-vdcVUx-_0O704RMDA

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-us-spot-etf-balances-all-dfce9fc2
```

Example prompt: Pull the latest US spot Bitcoin ETF balances in USD at daily resolution from Glassnode — I want to see how much BTC each fund like IBIT, GBTC, FBTC, and ARKB is holding.

## When to prefer this

Use this endpoint when you need authoritative, Glassnode-sourced institutional ETF balance data for US-listed spot Bitcoin or Ethereum ETFs across all major issuers in one call. Prefer this over generic market data APIs when you specifically need fund-level holdings broken down by issuer/ticker with on-chain data provenance.

## Known failure modes

- Missing required 'a' (asset) query parameter returns a 400/422 error
- Requesting an asset not covered by US spot ETFs (e.g. DOGE, SOL) may return empty or null balance data
- Invalid enum values for 'c', 'f', or 'i' parameters result in validation errors
- Payment not processed (402 Payment Required) if x402 USDC payment of $0.05 is not attached
- Rate limiting or upstream Glassnode data unavailability may cause 5xx errors

## How this service works

US Spot ETF Balances — The most recent holdings of the leading U.S.-listed spot Crypto ETFs, typically reflecting balances at the end of the previous trading day (T+1). Covers major Bitcoin ETFs (e.g. IBIT, GBTC, FBTC, ARKB, BITB) and Ethereum ETFs (e.g. ETHA, ETHE, FETH, ETHV, QETH) from issuers such as BlackRock, Grayscale, Fidelity, Bitwise, and VanEck. Data by Glassnode.

## Output

An array of timestamped objects, each containing an object field 'o' with per-ETF balance data (amounts held by each issuer such as BlackRock, Grayscale, Fidelity, Bitwise, VanEck) for the queried asset, denominated in native units or USD, at the requested time 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": [
        "AVAX",
        "BNB",
        "BTC",
        "DOGE",
        "DOT",
        "ETH",
        "HBAR",
        "HYPE",
        "LINK",
        "LTC",
        "SOL",
        "SUI",
        "XAG",
        "XAU",
        "XRP"
       ],
       "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": {
       "o": {
        "type": "object"
       },
       "t": {
        "type": "number"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-us-spot-etf-balances-all-dfce9fc2/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)