# x402stock Perpetuals Overview API

> x402stock Perpetuals Overview API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-12).

Returns a comprehensive overview of on-chain perpetuals data for a given coin, including candles, funding rates, order book, and market context from Hyperliquid.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/perps/overview/%7Bcoin%7D
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-perpetuals-overview-api-cb3d3406
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T-A6c9Jq2tqJe0nlfmjFD

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 x402stock-perpetuals-overview-api-cb3d3406
```

Example prompt: What's the current funding rate, open interest, mark price, and order book snapshot for BTC perpetuals on Hyperliquid right now?

## When to prefer this

Use this endpoint when you need a comprehensive on-chain perpetuals snapshot for a specific coin — combining candles, funding rates, order book, and market context in a single call. Prefer this over spot price APIs when you need derivatives-specific data like funding rate, open interest, or leverage. Ideal for DeFi trading analytics, funding rate arbitrage research, or on-chain perp monitoring without needing an API key.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty result
- Payment failure via x402 if USDC balance is insufficient
- Hyperliquid data unavailability causes partial section failures (sections field shows errors)
- Network timeout if Hyperliquid API is slow
- Coin not listed on Hyperliquid perps market returns not found

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: current candles (OHLCV with trade count and volume), market context (mark price, oracle price, mid price, open interest, funding rate hourly, funding APR, day volume in USD, max leverage, premium), funding rate history, and order book (top bids and asks with size and order count), all timestamped and sourced from Hyperliquid.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "as_of": "2026-06-04T12:00:00.000Z",
  "venue": "hyperliquid",
  "source": "x402stock",
  "candles": {
   "coin": "BTC",
   "as_of": "2026-06-04T00:00:00.000Z",
   "count": 1,
   "venue": "hyperliquid",
   "source": "x402stock",
   "candles": [
    {
     "end": "2026-06-01T00:59:59.999Z",
     "low": 71218,
     "high": 71589,
     "open": 71413,
     "close": 71411,
     "start": "2026-06-01T00:00:00.000Z",
     "trades": 17583,
     "volume": 3376.8
    }
   ],
   "interval": "1h"
  },
  "context": {
   "data": {
    "coin": "BTC",
    "premium": -0.0003457543,
    "mid_price": 63606.5,
    "mark_price": 63606,
    "max_leverage": 40,
    "oracle_price": 63629,
    "open_interest": 31304.105,
    "day_volume_usd": 6772680481.63,
    "prev_day_price": 64583,
    "day_volume_base": 106799.6,
    "funding_apr_percent": 10.95,
    "funding_rate_hourly": 0.0000125
   },
   "as_of": "2026-06-04T00:00:00.000Z",
   "venue": "hyperliquid",
   "market": "perp",
   "source": "x402stock"
  },
  "funding": {
   "coin": "BTC",
   "as_of": "2026-06-04T00:00:00.000Z",
   "count": 1,
   "venue": "hyperliquid",
   "source": "x402stock",
   "history": [
    {
     "time": "2026-06-03T00:00:00.000Z",
     "premium": -0.0003727867,
     "funding_apr_percent": 10.95,
     "funding_rate_hourly": 0.0000125
    }
   ]
  },
  "sections": {
   "candles": "ok",
   "context": "ok",
   "funding": "ok",
   "orderbook": "ok"
  },
  "orderbook": {
   "asks": [
    {
     "size": 5.04588,
     "price": 63591,
     "orders": 12
    }
   ],
   "bids": [
    {
     "size": 4.1275,
     "price": 63590,
     "orders": 10
    }
   ],
   "coin": "BTC",
   "as_of": "2026-06-04T00:00:00.000Z",
   "venue": "hyperliquid",
   "source": "x402stock"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-perpetuals-overview-api-cb3d3406/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)