# Hyperliquid Global Crypto Gainers Snapshot

> Hyperliquid Global Crypto Gainers Snapshot 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 top 24h gaining crypto perpetuals on Hyperliquid with market breadth, funding rates, volume, open interest, and advance/decline statistics.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v2/snapshot/locale/global/markets/crypto/gainers?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-global-crypto-gainers-snapshot-4bbadd11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fsTfjbz1AzB5VoT_mS6ZW

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-global-crypto-gainers-snapshot-4bbadd11
```

Example prompt: Show me the top 10 crypto gainers on Hyperliquid from the last 24 hours, filtered to coins with at least $2 million in daily volume, including their funding rates and open interest.

## When to prefer this

Choose this endpoint when you need a ranked leaderboard of top 24h gaining crypto perpetuals specifically on Hyperliquid, with accompanying funding rates, open interest, and market breadth context. Prefer this over generic price feeds when you need derivative-specific data (funding, OI, leverage) alongside momentum signals, and when you want built-in liquidity filtering. Ideal for trading agents scanning for momentum entries or carry-trade setups without needing a full API key setup — just pay $0.002 USDC per call via x402.

## Known failure modes

- Upstream Hyperliquid API unavailable — stale or empty data returned
- limit parameter outside 1–25 range — schema validation error
- min_volume_usd below 0 — schema validation error
- Payment failure via x402 — 402 response if USDC balance insufficient on Base
- top_gainers list empty if all coins are declining or universe is illiquid under the volume filter

## 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 the venue name (Hyperliquid), universe size, number of liquid coins, market breadth stats (advancers, decliners, advance ratio, label), and ranked lists including top_gainers with fields: coin, mark_px, change_24h_pct, volume_24h_usd, open_interest_usd, funding_apr_pct, vol_oi_ratio, premium_bps, max_leverage. Also includes updated_at timestamp and source URLs.

## 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-global-crypto-gainers-snapshot-4bbadd11/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)