# cryptofeed402 BTC Perpetuals Data

> cryptofeed402 BTC Perpetuals Data is a paid API for AI agents from cryptofeed402.site, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-21).

Returns a real-time snapshot of BTC perpetual futures data from Hyperliquid, including mark price, funding rate, open interest, 24h volume, and leverage info.

## Facts

- Endpoint: GET https://cryptofeed402.site/perps/BTC?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptofeed402-btc-perpetuals-data-6b301ed8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Z_p0BX6nmCQTMgGZAy6v

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 cryptofeed402-btc-perpetuals-data-6b301ed8
```

Example prompt: What's the current BTC perp funding rate and open interest on Hyperliquid — is funding extreme relative to other coins right now?

## When to prefer this

Choose this endpoint when you need real-time BTC perpetual futures data from Hyperliquid specifically, including funding rates, open interest, and leverage info, and you are operating in an x402-capable agent environment that can pay $0.002 USDC per call on Base mainnet. Prefer this over generic crypto price APIs when you need perp-specific metrics like funding rate extremity rankings, oracle vs mark price premium, and impact prices.

## Known failure modes

- 402 Payment Required — returned when no valid x402 USDC payment on Base mainnet is provided; response includes payment requirements
- Invalid or unsupported symbol — endpoint may return 404 or error if a non-BTC symbol is used at this path
- Stale or unavailable data — upstream Hyperliquid data may be temporarily unavailable, resulting in error or outdated as_of timestamp
- Network timeout — if Hyperliquid upstream is slow, response may be delayed

## How this service works

AI-to-AI crypto data. Paid routes use x402 (USDC on Base mainnet eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); unpaid calls return 402 with payment requirements. Not financial advice.

## Output

A JSON object with real-time BTC perp data including: mark price, oracle price, mid price, premium and premium percentage, funding rate (hourly, 8h, annualized APR), which side is paying funding, open interest in USD and BTC, 24h volume in USD, 24h price change percentage, max leverage, impact bid/ask prices, funding extremity rank among tracked coins, and a timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-19T20:57:31.782Z",
  "venue": "hyperliquid",
  "mid_px": 111655,
  "symbol": "BTC",
  "venues": [
   {
    "venue": "hyperliquid",
    "symbol": "BTC",
    "mark_px": 111650,
    "funding_rate": -0.0000052,
    "funding_apr_pct": -4.56,
    "open_interest_usd": 3461000000,
    "funding_interval_hours": 1
   }
  ],
  "funding": {
   "rate_8h": -0.0000416,
   "rate_hourly": -0.0000052,
   "side_paying": "shorts",
   "annualized_pct": -4.56,
   "interval_hours": 1
  },
  "mark_px": 111650,
  "premium": -0.00031,
  "impact_px": {
   "ask": 111660,
   "bid": 111640
  },
  "oracle_px": 111700,
  "disclaimer": "Automated data for AI agents. Not financial advice.",
  "premium_pct": -0.031,
  "generated_at": "2026-10-19T20:57:31.790Z",
  "max_leverage": 40,
  "open_interest": {
   "usd": 3461000000,
   "coins": 31000.5
  },
  "change_24h_pct": 1.2,
  "volume_24h_usd": 2100000000,
  "funding_extreme": {
   "rank": 8,
   "top10": [
    "SAND",
    "XMR"
   ],
   "in_top10": true,
   "ranked_universe": 67
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptofeed402-btc-perpetuals-data-6b301ed8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cryptofeed402.site](https://www.zero.xyz/host/cryptofeed402.site/llms.txt)