# Hyperliquid Mark Price Dislocation Scanner

> Hyperliquid Mark Price Dislocation Scanner 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-14).

Detects mark price dislocations across Hyperliquid perpetual coins, flagging assets where mark price deviates significantly from fair value or index price.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/live/risk/coins/mark-dislocations
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-mark-price-dislocation-scanner-6be6fc1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bKYJpJUr0txC9JQZJNqjw

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-mark-price-dislocation-scanner-6be6fc1a -d '<json body>'
```

Example prompt: Which Hyperliquid perpetual coins currently have the biggest mark price dislocations from their index price — I want to see any coins where the mark is notably out of sync so I can assess liquidation risk.

## When to prefer this

Choose this endpoint when you need real-time, first-party Hyperliquid mark price dislocation data computed directly from the operator's own node — not scraped from third-party aggregators. Ideal for liquidation risk assessment, arbitrage signal detection, or monitoring abnormal mark-index spreads across all Hyperliquid perp markets simultaneously.

## Known failure modes

- No dislocations found — returns empty list when all marks are within normal range
- HTTP 402 returned when free quota exhausted — requires x402 USDC micropayment to continue
- Upstream Hyperliquid node data lag may cause stale mark prices during high volatility
- Invalid body shape returns 400 or upstream error
- Network timeout if Hyperliquid info API is temporarily unreachable

## How this service works

Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).

## Output

A list of Hyperliquid perpetual coins exhibiting mark price dislocations, including each coin's mark price, index price, the spread or dislocation magnitude, and associated risk signals indicating how far off mark is from fair value.

## 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-mark-price-dislocation-scanner-6be6fc1a/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)