# Hyperliquid Perpetual Funding Rate API (x402)

> Hyperliquid Perpetual Funding Rate API (x402) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns live perpetual futures funding rate, mark price, oracle price, and open interest for BTC, ETH, or SOL from Hyperliquid, paid per-call via x402/USDC on Base.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/funding-rate?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perpetual-funding-rate-api-x402-a47d99fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NVCJuSy3-C1zCrTTn13_a

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-perpetual-funding-rate-api-x402-a47d99fb
```

Example prompt: What's the current hourly funding rate and annualized APR for BTC perpetuals on Hyperliquid right now?

## When to prefer this

Choose this endpoint when your AI agent needs real-time Hyperliquid perpetual funding rates and open interest without setting up API keys, and can pay $0.005 USDC per call via the x402 micropayment protocol on Base. Ideal for trading agents that need live funding data for BTC, ETH, or SOL perps to evaluate basis trades, funding arbitrage, or market sentiment without maintaining a centralized API key.

## Known failure modes

- Payment not made via x402/USDC — returns 402 Payment Required
- Invalid or unsupported coin symbol — only BTC, ETH, SOL accepted
- Upstream Hyperliquid API unavailable — may return 502 or stale data
- Malformed query parameter — returns 400 Bad Request
- Network timeout from Cloudflare Worker 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

Returns a JSON object with mark price, oracle price, open interest (raw and USD), hourly funding rate, annualized funding APR percentage, the venue name (hyperliquid), source URLs, and an updated_at timestamp for the requested coin.

## 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": {
       "enum": [
        "BTC",
        "ETH",
        "SOL"
       ],
       "type": "string",
       "examples": [
        "BTC",
        "ETH",
        "SOL"
       ],
       "description": "Perp coin (default BTC)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coins": {
   "BTC": {
    "mark_px": 80860,
    "oracle_px": 80870,
    "open_interest": 30000,
    "funding_hourly": 0.0000125,
    "funding_apr_pct": 10.95,
    "open_interest_usd": 2426000000
   }
  },
  "venue": "hyperliquid",
  "sources": [
   "https://api.hyperliquid.xyz/info"
  ],
  "updated_at": "2026-10-28T11:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetual-funding-rate-api-x402-a47d99fb/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)