# Laevitas Hyperliquid Node Instruments

> Laevitas Hyperliquid Node Instruments is a paid API for AI agents from apiv2.laevitas.ch, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Retrieves the list of tradeable instruments available on the Hyperliquid HyperCore node, filterable by market type (perp, spot, prediction, etc.)

## Facts

- Endpoint: GET https://apiv2.laevitas.ch/api/v1/hyperliquid/node/instruments
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/laevitas-hyperliquid-node-instruments-70f015bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WmWo-U65xX79tm0RWAHfz

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 laevitas-hyperliquid-node-instruments-70f015bc
```

Example prompt: Show me all available perpetual instruments currently listed on the Hyperliquid HyperCore node, limited to 100 results.

## When to prefer this

Use this endpoint when you need to discover or enumerate the full set of tradeable instruments on Hyperliquid's HyperCore node, especially when building instrument pickers, validating instrument names before querying market data, or exploring what prediction or spot markets exist on Hyperliquid. Prefer this over generic exchange instrument endpoints when your workflow specifically targets Hyperliquid HyperCore.

## Known failure modes

- Invalid market_type enum value returns 400 bad request
- Exceeding limit of 1000 returns validation error
- Invalid cursor value causes pagination failure
- Missing or invalid API key / x402 payment returns 401/402
- Empty data array if no instruments match the filter criteria
- Network timeout on slow upstream Hyperliquid node data

## How this service works

Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.

## Authentication

Use an API key for authenticated REST requests:

```http
X-API-Key: your-api-key-here
```

Most data endpoints also support x402 pay-per-request without an API key.

| Resource | Path |
| --- | --- |
| OpenAPI JSON | `GET /openapi.json` |
| x402 discovery | `GET /.well-known/x402` |
| Changelog | `GET /api/v1/changelog` |
| WebSocket docs | `GET /websocket` |

## REST Surfaces

| Surface | Examples |
| --- | --- |
| Instruments | Cross-market contract reference data |
| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |
| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |
| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |
| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |
| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |
| Predictions | Polymarket instruments, categories, trades, ticker history |
| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |
| Analytics | Realized volatility and derived metrics |

## Pagination

Paginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.

## WebSocket Streaming

Real-time streams are documented at `/websocket`.

| Data | Channel pattern |
| --- | --- |
| Trades | `trades.{market}.{exchange}.{instrument}` |
| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |
| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |

Variables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.

## Quick Start

```bash
curl "https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL" \
  -H "X-API-Key: your-api-key-here"
```

## Output

Returns a JSON object with a 'data' array containing instrument reference entries for Hyperliquid node markets, along with a 'success' boolean. Each entry describes a tradeable instrument including its name and market type (perp, spot, prediction, perp_hip3).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1
      },
      "start": {
       "type": "string"
      },
      "cursor": {
       "type": "string"
      },
      "dedupe": {
       "type": "boolean"
      },
      "wallet": {
       "type": "string"
      },
      "sort_by": {
       "enum": [
        "time",
        "total_notional",
        "buy_notional",
        "sell_notional",
        "net_notional",
        "realized_pnl",
        "trade_count"
       ],
       "type": "string"
      },
      "currency": {
       "type": "string"
      },
      "exchange": {
       "type": "string"
      },
      "resolution": {
       "enum": [
        "1m",
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
       ],
       "type": "string"
      },
      "market_type": {
       "enum": [
        "perp",
        "perp_hip3",
        "spot",
        "prediction"
       ],
       "type": "string"
      },
      "min_notional": {
       "type": "number"
      },
      "instrument_name": {
       "type": "string"
      },
      "instrument_name_raw": {
       "type": "string"
      },
      "min_target_notional": {
       "type": "number"
      },
      "max_distance_from_mark": {
       "type": "number"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/laevitas-hyperliquid-node-instruments-70f015bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiv2.laevitas.ch](https://www.zero.xyz/host/apiv2.laevitas.ch/llms.txt)