# Hyperliquid Market Data Lookup

> Hyperliquid Market Data Lookup is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns mark price, size decimals, max leverage, margin table ID, and active market list for Hyperliquid perpetuals futures markets

## Facts

- Endpoint: POST https://x402.agentutility.ai/hyperliquid-market
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-market-data-lookup-47c517b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ARePoMplZ9Ffx1q79_7C2

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 hyperliquid-market-data-lookup-47c517b4 -d '<json body>'
```

Example prompt: What's the current mark price and max leverage for ETH perpetuals on Hyperliquid, and can you also list all the active perp markets available right now?

## When to prefer this

Use this endpoint when you need low-cost, lightweight access to Hyperliquid-specific perpetuals market data — specifically mark price, leverage, and market parameters — without needing order book depth, trade history, or private account data. Prefer this over generic crypto price APIs when the user explicitly needs Hyperliquid perps context (mark price vs spot, max leverage, size decimals). It is cheaper and more targeted than full-featured exchange aggregators.

## Known failure modes

- Market symbol not found or not active on Hyperliquid — returns empty or error response
- Hyperliquid public info API is temporarily unavailable — upstream timeout or error
- Invalid input format for coin/symbol — may return null or malformed response
- Rate limiting or payment failure at x402 layer — 402 payment required or rejected

## How this service works

Hyperliquid market API / Hyperliquid market data / perps mark price / crypto futures market lookup. Low-cost exact-demand endpoint for active Hyperliquid markets. Returns mark price, size decimals, max leverage, margin table id, and active market list from Hyperliquid's public info API. Read-only; no wallet data, trading, private API keys, or order routing.

## Output

Returns structured data for one or all Hyperliquid perpetual futures markets, including the current mark price, size decimals (precision for order sizing), maximum available leverage, and margin table ID. Also returns the full list of active markets available on the exchange.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "mode": {
       "enum": [
        "market"
       ],
       "type": "string",
       "description": "Lookup mode. Only read-only market data is enabled. Default 'market'."
      },
      "limit": {
       "type": "number",
       "description": "Maximum records to return when market is omitted. Suggested range 1-50."
      },
      "market": {
       "type": "string",
       "description": "Hyperliquid market or symbol, e.g. 'BTC', 'ETH', or 'SOL'."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "market": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "mark_price": {
       "type": "number"
      },
      "max_leverage": {
       "type": "integer"
      },
      "size_decimals": {
       "type": "integer"
      },
      "margin_table_id": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "market": "BTC",
  "source": "Hyperliquid public info API",
  "mark_price": 104250.5,
  "max_leverage": 40,
  "size_decimals": 5,
  "margin_table_id": 56
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-market-data-lookup-47c517b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)