# Hyperliquid Open Interest Top Ranking

> Hyperliquid Open Interest Top Ranking is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Returns a ranked snapshot of Hyperliquid perpetuals by open interest, volume, funding, and market breadth — paid per-call via x402 USDC micropayment.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/nofx/oi/top-ranking?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-open-interest-top-ranking-10976c3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0BGN4uLCeFzdWeT83-fiF

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-open-interest-top-ranking-10976c3a
```

Example prompt: Show me the top 15 Hyperliquid perpetuals ranked by open interest, filtering for coins with at least $5M in 24h volume — include gainers, funding rates, and the overall market breadth.

## When to prefer this

Choose this endpoint when an AI agent needs a single ranked snapshot of the entire Hyperliquid perpetuals market — covering open interest, funding, volume, gainers/losers, and breadth — without managing API keys. It is ideal for momentum screening, funding arbitrage detection, or daily market summaries. Prefer it over raw Hyperliquid API calls when micropayment simplicity (x402, no key management) matters, and over generic crypto data APIs when Hyperliquid-specific funding and OI ranking is the core need.

## Known failure modes

- Payment not included or malformed x402 USDC payment header — returns 402 Payment Required
- limit parameter outside 1–25 range — returns 400 validation error
- min_volume_usd below 0 — returns 400 validation error
- Hyperliquid upstream API unavailable — may return 502 or stale data
- No coins pass the min_volume_usd filter — ranked arrays return empty

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

A JSON object with venue metadata, universe and liquid coin counts, advance/decline breadth (label, advancer/decliner counts, advance ratio), and ranked arrays for top gainers, top losers, top volume, top open interest, highest funding, most negative funding, and unusual activity — each entry including coin name, mark price, 24h change %, 24h volume USD, open interest USD, funding APR %, vol/OI ratio, max leverage, and premium bps.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Rows per ranking (default 10)"
      },
      "min_volume_usd": {
       "type": "number",
       "minimum": 0,
       "description": "Liquidity filter on 24h notional volume (default 1000000)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "venue": "hyperliquid",
  "liquid": 140,
  "breadth": {
   "label": "broad_rally",
   "advancers": 96,
   "decliners": 44,
   "advance_ratio": 0.686
  },
  "sources": [
   "https://api.hyperliquid.xyz/info"
  ],
  "universe": 230,
  "top_losers": [],
  "top_volume": [],
  "updated_at": "2026-10-29T16:00:00Z",
  "top_gainers": [
   {
    "coin": "HYPE",
    "mark_px": 41.2,
    "premium_bps": -1.1,
    "max_leverage": 10,
    "vol_oi_ratio": 0.34,
    "change_24h_pct": 8.4,
    "volume_24h_usd": 410000000,
    "funding_apr_pct": 14.2,
    "open_interest_usd": 1200000000
   }
  ],
  "highest_funding": [],
  "unusual_activity": [],
  "top_open_interest": [],
  "most_negative_funding": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-open-interest-top-ranking-10976c3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)