# US Bitcoin ETF Market Data API

> US Bitcoin ETF Market Data API is a paid API for AI agents from claw402.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns real-time market data for US-listed Bitcoin spot ETFs, including price, NAV, premium/discount, net inflows, BTC holdings, and issuer details.

## Facts

- Endpoint: GET https://claw402.ai/api/v1/coinank/etf/us-btc
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-bitcoin-etf-market-data-api-48840d13
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a9USQpZgDNEZ4mkfNCHxM

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 us-bitcoin-etf-market-data-api-48840d13
```

Example prompt: Can you pull up the latest market data for all US Bitcoin spot ETFs — I want to see prices, NAV, premium/discount, net inflows, and how much BTC each fund is holding, especially BlackRock's IBIT?

## When to prefer this

Use this endpoint when you need comprehensive, real-time US Bitcoin spot ETF data including fund flows, BTC holdings, NAV, and premium/discount in a single call — especially when you want to avoid API key registration and pay per-call in USDC via x402. Prefer over traditional financial data APIs when you need permissionless, wallet-based access.

## Known failure modes

- Payment not included or insufficient USDC — returns HTTP 402 requiring x402 payment
- Malformed or missing 'properties' parameter — may return empty data array
- Upstream vergex.trade data source unavailable — returns code non-zero or empty data
- Rate limit or wallet issue — payment rejected by gateway

## How this service works

Backed by vergex.trade. Pay for any API with USDC. No API keys. No registration. Just a wallet.

## Output

A JSON array of objects for each US Bitcoin ETF, each containing: ticker, ETF name, issuer, custodian, current price, price change, NAV, premium/discount rate, net inflow, BTC amount held (total and 24h/7d changes), shares outstanding, market cap, total assets, management fee, fee waiver, and status. Keyed under 'data' with a status code.

## Example request

```json
{
 "properties": "us-btc"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-bitcoin-etf-market-data-api-48840d13/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from claw402.ai](https://www.zero.xyz/host/claw402.ai/llms.txt)
