# ETF Holdings – Spot Bitcoin & Ethereum ETF Data

> ETF Holdings – Spot Bitcoin & Ethereum ETF Data is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns latest per-fund holdings (coin units, market value, shares outstanding), total AUM, and largest-fund AUM share for spot BTC or ETH ETFs in a given region.

## Facts

- Endpoint: GET https://payai.agentstools.dev/etf/holdings
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/etf-holdings-spot-bitcoin-ethereum-etf-data-8729fdee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v9Ox2L3dU1amr2vu96ogM

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 etf-holdings-spot-bitcoin-ethereum-etf-data-8729fdee
```

Example prompt: What are the latest holdings for US spot Bitcoin ETFs — show me coin units, market value, and shares outstanding per fund, plus the total AUM and which fund dominates?

## When to prefer this

Use this endpoint when you need a single normalized call to get cross-fund ETF holdings data for spot Bitcoin or Ethereum ETFs, including per-fund breakdown and aggregate AUM metrics, sourced directly from issuer disclosures. Prefer it over scraping individual ETF issuer sites or using general financial data APIs that don't specialize in crypto ETF holdings.

## Known failure modes

- Missing required 'asset' or 'region' query parameter returns a 400 validation error
- Unsupported asset/region combination (e.g. 'eth' + 'hk') may return empty data or a scaffold placeholder
- Stale issuer disclosures may mean holdings data lags real-time market values
- Network or upstream data source outages may return 5xx errors
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Latest holdings for spot Bitcoin or Ethereum ETFs from issuer disclosures: per-fund coin units (or shares), market value and shares outstanding, plus total AUM across funds and the largest fund's AUM share. One normalized call.

## Output

A normalized response containing per-fund data (coin units or shares held, market value, shares outstanding) for each spot BTC or ETH ETF in the requested region, along with aggregate total AUM across all funds and the AUM share of the largest single fund.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "asset",
      "region"
     ],
     "properties": {
      "asset": {
       "enum": [
        "btc",
        "eth"
       ],
       "type": "string",
       "description": "Crypto asset whose spot ETFs to report: btc or eth."
      },
      "region": {
       "enum": [
        "us",
        "hk"
       ],
       "type": "string",
       "description": "ETF listing region: us (live) or hk (scaffold)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/etf-holdings-spot-bitcoin-ethereum-etf-data-8729fdee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)