# Crypto Top Movers – Hyperliquid Market Breadth & Rankings

> Crypto Top Movers – Hyperliquid Market Breadth & Rankings 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 ranked lists of top-gaining, top-losing, highest-funding, and most-active perpetuals on Hyperliquid, plus market breadth metrics like advance/decline ratio.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/crypto/top-movers?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/crypto-top-movers-hyperliquid-market-breadth-rankings-348a298f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E-UBSLQbXk2qorlQMrMk_

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 crypto-top-movers-hyperliquid-market-breadth-rankings-348a298f
```

Example prompt: Show me the top 15 gaining and losing crypto perpetuals on Hyperliquid right now, only including coins with at least $5 million in 24-hour volume, and give me the overall market breadth summary.

## When to prefer this

Choose this endpoint when you need a ranked, multi-dimensional snapshot of the entire Hyperliquid perpetuals market in a single call — including breadth, funding, volume, and momentum — without managing API keys. Ideal for trading agents that need market-wide context before executing a trade, or for monitoring bots that need to surface the day's standout movers quickly. Prefer this over raw exchange APIs when you want pre-filtered, agent-ready JSON with funding and OI data combined.

## Known failure modes

- Payment failure (402): USDC balance on Base insufficient for $0.002 per-call fee
- Hyperliquid API unavailable: upstream data source unreachable, stale or empty response
- Invalid query params: limit outside 1-25 range or min_volume_usd below 0 returns 400
- No coins pass volume filter: empty ranked arrays if min_volume_usd is set too high
- Rate limiting or worker timeout on Cloudflare edge

## 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 containing ranked arrays of top gainers, top losers, top-volume coins, highest funding rate coins, most negative funding coins, unusual activity flags, and top open interest coins. Each coin entry includes mark price, 24h change percent, funding APR, 24h USD volume, open interest USD, vol/OI ratio, max leverage, and premium basis points. Also returns overall market breadth stats (advancers, decliners, advance ratio, breadth label), total universe size, number of liquid coins, data source URLs, and an updated_at timestamp.

## 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/crypto-top-movers-hyperliquid-market-breadth-rankings-348a298f/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)