# Hyperliquid Perpetual Funding Rate Lookup

> Hyperliquid Perpetual Funding Rate Lookup 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 current mark price, oracle price, open interest, and hourly/APR funding rates for BTC, ETH, or SOL perpetual futures on Hyperliquid via x402 micropayment

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v1/funding?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-lookup-0487b234
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iHNvUwWH6QjFkJthEuEni

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-lookup-0487b234
```

Example prompt: What's the current hourly funding rate and annualized APR for BTC perpetuals on Hyperliquid, and how does the mark price compare to the oracle price right now?

## When to prefer this

Choose this endpoint when you need real-time Hyperliquid-specific perpetual funding rates and open interest for BTC, ETH, or SOL without setting up an API key — especially in onchain or autonomous agent contexts where x402 micropayments via USDC on Base are available. Prefer this over general crypto data APIs when Hyperliquid-specific mark/oracle price spread or funding APR is specifically required for trading decisions.

## Known failure modes

- Payment failure: x402 USDC payment on Base not completed or insufficient balance
- Invalid coin: coin parameter not in allowed enum (BTC/ETH/SOL) returns error
- Upstream outage: Hyperliquid API unavailable causes stale or missing data
- Rate limit: excessive calls without valid payment rejected
- Network timeout: Cloudflare Worker timeout on slow upstream response

## 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, venue name (hyperliquid), data source URLs, and an ISO 8601 timestamp of last update — all for the requested coin (BTC, ETH, or SOL).

## 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-lookup-0487b234/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)