# 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 down (last checked 2026-09-15).

Detects and returns real-time mark price dislocations across Hyperliquid perpetual coins, flagging coins where mark price significantly deviates from expected fair value

## Facts

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

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-f188e9b9 -d '<json body>'
```

Example prompt: Show me which Hyperliquid perpetual coins are currently experiencing significant mark price dislocations — I want to know which markets have the biggest gap between mark price and fair value right now.

## When to prefer this

Use this endpoint when you need real-time, first-party mark price dislocation intelligence for Hyperliquid perpetuals without requiring an account or API key. It is ideal for risk agents monitoring liquidation exposure, traders scanning for arbitrage, or automated systems that need on-demand mark price anomaly detection at low per-call cost ($0.001 USDC). Prefer this over generic market data APIs when you specifically need Hyperliquid perp mark price vs fair value divergence computed from raw node_fills data.

## Known failure modes

- Payment required: endpoint returns HTTP 402 if the $0.001 USDC x402 payment on Base is not included or fails
- Invalid body: malformed JSON payload returns a 400 error
- No dislocations found: empty result set returned if all mark prices are within normal range
- Upstream data lag: Hyperliquid public info API latency may cause briefly stale mark prices
- Rate limiting: excessive calls without valid payment may be rejected

## 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

A list of Hyperliquid perpetual coins currently exhibiting mark price dislocations, including the magnitude and direction of each deviation, enabling traders to assess liquidation risk, spot anomalies, or identify potential arbitrage setups. Computed from first-party node_fills ledger data.

## 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-f188e9b9/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)