# Hyperliquid Market Movers via x402

> Hyperliquid Market Movers via x402 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-11-02).

Returns top gainers, losers, highest funding, and market breadth stats for Hyperliquid perpetuals, paid per-call with USDC via x402.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/hyperliquid/movers?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-market-movers-via-x402-e731fc1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V6rDF5mLKW1QyUD0QF13h

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-market-movers-via-x402-e731fc1e
```

Example prompt: Show me the top 15 gainers on Hyperliquid right now, filtering for coins with at least $5 million in 24h volume, and include their funding rates and open interest.

## When to prefer this

Choose this endpoint when you need a ranked, multi-dimensional market scan of Hyperliquid perpetuals — especially when you want breadth stats alongside top movers and funding data in a single call. Prefer it over building your own Hyperliquid data pipeline when you want pay-per-call pricing with no API key management. Best suited for trading agents that need periodic market snapshots rather than tick-level streaming data.

## Known failure modes

- Payment failure if USDC balance on Base is insufficient (x402 payment required)
- Hyperliquid upstream API unavailable causing stale or empty data
- limit parameter out of range 1-25 returns validation error
- min_volume_usd below 0 returns validation error
- Empty result arrays if no coins meet the volume filter threshold

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

Returns a JSON object with venue metadata, market breadth stats (advancers, decliners, advance ratio, label), and ranked arrays for top gainers, top losers, top volume, highest funding, most negative funding, and unusual activity. Each coin entry includes mark price, 24h change %, funding APR %, open interest USD, volume 24h USD, vol/OI ratio, premium bps, and max leverage.

## 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-market-movers-via-x402-e731fc1e/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)