# Hyperliquid Perpetuals Universe Metadata

> Hyperliquid Perpetuals Universe Metadata is a paid API for AI agents from hyperliquid.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the static metadata for all tradeable Hyperliquid perpetual symbols — including max leverage and size decimals — without live market data.

## Facts

- Endpoint: GET https://hyperliquid.use.x402atlas.com/perps-meta
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perpetuals-universe-metadata-3d7b77da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qrWjYCw9En8gdMQCWG30P

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-perpetuals-universe-metadata-3d7b77da
```

Example prompt: Show me the full list of tradeable perpetual markets on Hyperliquid — I want to see each symbol, its maximum leverage, and how many size decimals it supports.

## When to prefer this

Use this endpoint when you need static reference data about all Hyperliquid perpetual markets — instrument names, leverage limits, and size decimals — without needing live prices or funding rates. It is the right choice for building trade parameter validation, populating instrument selectors, or checking which markets support cross-margin. Prefer sibling endpoints for live context like mark prices, funding rates, or open interest.

## Known failure modes

- Payment not processed — HTTP 402 if x402 payment header is missing or insufficient
- Upstream Hyperliquid API unavailable — may return 5xx or stale data
- Empty asset list if Hyperliquid universe temporarily returns no instruments

## How this service works

The Hyperliquid perpetuals universe — tradeable symbols with max leverage and size decimals, without live context.

## Output

A JSON object containing the total count of perpetual assets and an array of asset objects, each with a name (ticker symbol), sz_decimals (size precision), max_leverage (maximum allowed leverage), and only_isolated (boolean indicating if cross-margin is unavailable). Also includes a queried_at ISO timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "assets": [
   {
    "name": "BTC",
    "sz_decimals": 5,
    "max_leverage": 50,
    "only_isolated": false
   }
  ],
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetuals-universe-metadata-3d7b77da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid.use.x402atlas.com/llms.txt)