# Hyperliquid Funding Rate Extremes

> Hyperliquid Funding Rate Extremes is a paid API for AI agents from chiefofstaff-solana.iodized-lemon.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns the top positive and negative funding rate coins across all Hyperliquid perpetual markets, with OI, volume, and predicted rates.

## Facts

- Endpoint: GET https://chiefofstaff-solana.iodized-lemon.workers.dev/hl/funding?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-funding-rate-extremes-cb4b2c9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bG1ZPocupFoLEePIuTzef

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-funding-rate-extremes-cb4b2c9a
```

Example prompt: Show me the top 10 coins with the most extreme funding rates on Hyperliquid right now — both the highest positive and most negative — so I can spot funding arbitrage opportunities.

## When to prefer this

Use this endpoint when you need a quick, ranked view of funding rate extremes across all Hyperliquid perpetuals for funding arbitrage screening, sentiment analysis, or pre-trade cost estimation. It aggregates and ranks all HL perps in one call rather than requiring you to poll each market individually. Prefer it over raw Hyperliquid API access when you want a pre-processed, LLM-ready response with an OI-weighted aggregate and freshness metadata, and when the $0.002 per-call cost is acceptable. Not suitable for real-time tick data or order execution.

## Known failure modes

- Data older than expected if Hyperliquid public feed is delayed — age_s will reflect staleness
- Invalid coin ticker returns empty or filtered results rather than an error
- limit parameter outside 1-25 range may default or return an error
- Payment not confirmed — x402 payment required before data is returned
- Network timeout on the worker edge if HL public data source is temporarily unavailable

## How this service works

Paid token safety / rug-pull checks for AI agents: Solana SPL (/check) and Robinhood Chain ERC-20 (/rh/check). One-sentence verdict + blocking/warnings/unknowns, casino|speculative|legit tier, holder count & concentration, liquidity, 1h volume & buy/sell flow, honeypot/tax or mint/freeze authority, RugCheck/GoPlus cross-checks. $0.01 USDC on Base or Solana via x402. Also: Hyperliquid perp market data for trading agents: funding extremes across all HL perps ($0.002), whale liquidation levels ($0.003), whale net positioning ($0.005), and a one-call LLM-ready market brief ($0.008). Refreshed ~every 3 min from HL public data; every response has generated_at/age_s; stale data is never charged.

## Output

A JSON object containing two ranked lists (top_positive and top_negative) of perps by funding rate, each with coin ticker, mark price, open interest in USD, 24h volume, OI change over 24h, premium in basis points, 1h funding rate pct, predicted 1h funding pct, and annualized funding APR. Also includes an OI-weighted aggregate APR, the endpoint path, a generated_at UTC timestamp, and age_s (seconds since last refresh, ~3 min cadence). Stale data is never charged.

## 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": {
      "coin": {
       "type": "string",
       "description": "Optional HL perp ticker, e.g. BTC, ETH, SOL, HYPE"
      },
      "limit": {
       "type": "string",
       "description": "Rows per side, 1-25 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "age_s": 41,
  "endpoint": "/hl/funding",
  "generated_at": "2026-10-07T20:00:59Z",
  "top_negative": [
   {
    "coin": "XYZ",
    "funding_1h_pct": -0.006,
    "funding_apr_pct": -52.6
   }
  ],
  "top_positive": [
   {
    "coin": "RESOLV",
    "mark": 0.21,
    "oi_usd": 3120000,
    "vol24h_usd": 18000000,
    "premium_bps": 4.1,
    "funding_1h_pct": 0.00423,
    "oi_chg_24h_pct": 12.4,
    "funding_apr_pct": 37.1,
    "predicted_1h_pct": 0.0041
   }
  ],
  "oi_weighted_apr_pct": 8.9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-funding-rate-extremes-cb4b2c9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chiefofstaff-solana.iodized-lemon.workers.dev](https://www.zero.xyz/host/chiefofstaff-solana.iodized-lemon.workers.dev/llms.txt)
