# Hyperliquid Perpetual Futures Market Overview (x402stock)

> Hyperliquid Perpetual Futures Market Overview (x402stock) is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.03/call, status unknown (last checked 2026-10-11).

Returns a complete snapshot of one Hyperliquid on-chain perpetual futures market in a single call: live mark/oracle price, funding rate, open interest, funding history, L2 order book, and OHLCV candles.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/overview/{coin}?utm_source=zero.xyz
- Price: $0.03/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-market-overview-424a14ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jx_aCe6HaHaqcM_ZTSIOW

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 agents-x402stock-xyz-hyperliquid-perpetual-futures-market-overview-424a14ed
```

Example prompt: Pull the full market overview for BTC perpetuals on Hyperliquid — I want the live mark price, oracle price, funding rate, open interest, order book, and recent candles all in one shot.

## When to prefer this

Use this endpoint when you need a comprehensive view of a single Hyperliquid perpetual market in one call — it replaces four separate calls (perps/{coin}, funding, orderbook, candles) at a lower combined cost of $0.03. Prefer this over individual endpoints when you need two or more of: live price/funding, order book, or candle data for the same coin. It is the right choice for trading bots, market monitoring agents, or dashboards that need a full market snapshot without assembling multiple API calls.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty sections
- Individual sections (funding, orderbook, candles) may return null if that data source is temporarily unavailable — sections degrade independently
- Network timeout or Hyperliquid DEX downtime may cause partial or full failure
- Rate limiting or payment failure via x402 returns a 402 Payment Required response
- Coin symbols are case-sensitive; wrong casing may return no data

## How this service works

Returns live context, funding history, order book, and price candles for one perp market.

## Output

A JSON object containing: (1) context section with live mark price, oracle price, mid price, funding rate (hourly and APR), open interest, premium, day volume in USD and base units, max leverage, and previous day price; (2) funding section with recent historical funding rate entries; (3) orderbook section with the current L2 bid/ask ladder; (4) candles section with OHLCV bars including open, high, low, close, volume, and trade count per interval. All sections degrade independently if one data source is temporarily unavailable. Metadata includes coin, venue (hyperliquid), source, and as_of timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "coin"
 ],
 "properties": {
  "coin": {
   "type": "string",
   "description": "Hyperliquid perpetual coin symbol, e.g. BTC or ETH."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "coin",
  "source",
  "venue",
  "as_of",
  "sections",
  "context",
  "funding",
  "orderbook",
  "candles"
 ],
 "properties": {
  "coin": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string",
   "const": "hyperliquid"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "candles": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "source",
      "as_of",
      "venue",
      "coin",
      "interval",
      "count",
      "candles"
     ],
     "properties": {
      "coin": {
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "venue": {
       "type": "string"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "candles": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "start",
         "end",
         "open",
         "high",
         "low",
         "close",
         "volume",
         "trades"
        ],
        "properties": {
         "end": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "low": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "high": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "open": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "close": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "start": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "trades": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "volume": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-market-overview-424a14ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)