# Hyperliquid Live Mark Dislocations

> Hyperliquid Live Mark Dislocations is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Identifies real-time mark price dislocations across Hyperliquid perpetual markets, highlighting assets where mark prices deviate significantly from expected fair value

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/live/mark-dislocations
- 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-live-mark-dislocations-5c7f6bfd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mPVu0eDzH_r7B74uGpEpy

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-live-mark-dislocations-5c7f6bfd -d '<json body>'
```

Example prompt: Scan all Hyperliquid perpetual markets right now and show me which assets have the biggest mark price dislocations from their index — I want to spot any unusual spreads or mispricing.

## When to prefer this

Choose this endpoint when you need real-time, first-party mark price dislocation data specifically from Hyperliquid's perpetual markets, computed directly from Hyperliquid's own node fills and public API rather than a third-party aggregator. Prefer this over generic crypto data APIs when you need Hyperliquid-native precision, and over polling the Hyperliquid public API yourself when you want pre-computed dislocation signals without building your own detection logic. It is especially useful for trading bots, arbitrage scanners, and risk monitoring agents that need low-latency anomaly detection with no account or API key requirement.

## Known failure modes

- Payment not settled via x402 on Base — returns 402 Payment Required
- Invalid or missing JSON body — returns 400 Bad Request
- Hyperliquid public API temporarily unavailable — may return 503 or stale data
- No dislocations detected — returns empty result set
- Malformed request body schema — returns validation error

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

Returns a list of Hyperliquid perpetual markets exhibiting mark price dislocations, including the affected asset symbols, magnitude of the dislocation, direction (above or below index), and relevant market context such as funding rates or open interest, all computed from Hyperliquid's own node fills ledger and public info API.

## 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": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-live-mark-dislocations-5c7f6bfd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)