# Hyperliquid Perpetuals Funding & OI Data

> Hyperliquid Perpetuals Funding & OI Data is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns real-time funding rates, open interest, mark/oracle/mid prices, 24h volume, and predicted funding arbitrage signals for a Hyperliquid perpetual futures market by coin symbol.

## Facts

- Endpoint: GET https://1gateway.dev/v1/crypto/hyperliquid/perp?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perpetuals-funding-oi-data-aed2dfab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ilnM83MlK4sAWf4CUJ-_x

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-perpetuals-funding-oi-data-aed2dfab
```

Example prompt: What's the current funding rate and open interest for BTC perpetuals on Hyperliquid, and is there a funding arbitrage opportunity between Hyperliquid and Binance right now?

## When to prefer this

Choose this endpoint when you need normalized, clean English JSON for Hyperliquid perpetuals market data — specifically funding rates, open interest, and cross-venue funding arbitrage signals — without setting up API keys or managing authentication. Ideal for AI agents that pay per call in USDC on Base via x402 and need real-time perp data for BTC, ETH, SOL, HYPE, kPEPE, and other Hyperliquid-listed coins. Prefer this over raw Hyperliquid API calls when you want pre-computed annualized rates, basis percentages, and arbitrage analysis already normalized into clean JSON.

## Known failure modes

- 400 error (not charged) if the coin symbol is not listed or has been delisted on Hyperliquid
- 400 error if the coin parameter does not match the required pattern (1-20 alphanumeric characters)
- Hyperliquid info API downtime may result in upstream errors
- Stale data possible if cache_age_s is non-zero, indicating a cached response

## How this service works

Hyperliquid vs Binance vs Bybit predicted funding comparison for one perpetual futures market, plus current funding rate, open interest and basis. Use when an agent monitors a perp position or funding carry. Input: coin (e.g. BTC, ETH, kPEPE). Output: JSON as_of, cache_age_s, 1h + annualized funding, OI coin/USD, mark/oracle/mid, basis %, premium, 24h volume and change, per-venue predicted funding, annualized spread. Unknown coin: 400, not charged. Example: ?coin=BTC

## Output

A JSON object containing: coin symbol, timestamp, market metadata (size decimals, max leverage), price data (mid, mark, oracle, premium, prevDay, basis %, 24h change %), funding data (1h rate, 1h rate %, annualized %, interval hours), 24h volume in USD and base units, open interest in USD and coin units, predicted funding rates from multiple venues with next funding times, and a funding arbitrage analysis indicating which venue to long vs short and the gross annualized spread. Also includes cache age in seconds and a data disclaimer.

## 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",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{1,20}$",
       "examples": [
        "BTC"
       ],
       "description": "Hyperliquid perp symbol, case-insensitive (BTC, ETH, SOL, HYPE, kPEPE). Not listed or delisted → 400 before payment (not charged)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "as_of",
      "cache_age_s",
      "coin",
      "market",
      "funding",
      "prices",
      "openInterest",
      "volume24h",
      "predictedFunding",
      "source",
      "disclaimer"
     ],
     "properties": {
      "coin": {
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "market": {
       "type": "object",
       "properties": {
        "szDecimals": {
         "type": "integer"
        },
        "maxLeverage": {
         "type": "integer"
        }
       }
      },
      "prices": {
       "type": "object",
       "properties": {
        "mid": {
         "type": [
          "number",
          "null"
         ]
        },
        "mark": {
         "type": [
          "number",
          "null"
         ]
        },
        "oracle": {
         "type": [
          "number",
          "null"
         ]
        },
        "premium": {
         "type": [
          "number",
          "null"
         ]
        },
        "prevDay": {
         "type": [
          "number",
          "null"
         ]
        },
        "basisPct": {
         "type": [
          "number",
          "null"
         ]
        },
        "change24hPct": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "source": {
       "type": "string"
      },
      "funding": {
       "type": "object",
       "properties": {
        "rate1h": {
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "as_of": "2026-10-17T06:49:10.000Z",
  "market": {
   "szDecimals": 5,
   "maxLeverage": 40
  },
  "prices": {
   "mid": 81590.5,
   "mark": 81587.6,
   "oracle": 81620.4,
   "premium": -0.0003602041,
   "prevDay": 82128,
   "basisPct": -0.0402,
   "change24hPct": -0.66
  },
  "source": "Hyperliquid info API (metaAndAssetCtxs, predictedFundings)",
  "funding": {
   "rate1h": 0.0000125,
   "ratePct1h": 0.00125,
   "annualizedPct": 10.95,
   "intervalHours": 1
  },
  "volume24h": {
   "usd": 2714721890,
   "base": 33239.11434
  },
  "disclaimer": "Informational market data derived from Hyperliquid's info API; not financial advice. Funding is a rate per interval paid by longs to shorts when positive; annu…",
  "cache_age_s": 0,
  "openInterest": {
   "usd": 3353306195,
   "coin": 41100.68436
  },
  "predictedFunding": {
   "venues": [
    {
     "rate": 0.00005049,
     "venue": "binance",
     "ratePer1h": 0.00000631125,
     "annualizedPct": 5.53,
     "intervalHours": 8,
     "nextFundingTime": "2026-10-17T08:00:00.000Z"
    }
   ],
   "arbitrage": {
    "note": "Gross predicted carry: short the higher-funding venue, long the lower; before fees, slippage and basis moves",
    "longVenue": "binance",
    "shortVenue": "hyperliquid",
    "annualizedSpreadPct": 5.42
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetuals-funding-oi-data-aed2dfab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)
