# Hyperliquid Perpetuals Carry/Funding Rate Data (x402)

> Hyperliquid Perpetuals Carry/Funding Rate Data (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 real-time perpetual futures carry data (mark price, oracle price, open interest, hourly funding rate, annualized funding APR) for BTC, ETH, or SOL from Hyperliquid via a pay-per-call x402 micropayment model.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/perpetuals/carry?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-perpetuals-carry-funding-rate-data-x402-898dafd2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gOKhTkEWDDpjz2gDxFtBE

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-carry-funding-rate-data-x402-898dafd2
```

Example prompt: What's the current funding rate and annualized carry APR for BTC perpetuals on Hyperliquid? I want to know if there's a positive carry opportunity.

## When to prefer this

Choose this endpoint when you need real-time perpetual futures funding/carry data specifically from Hyperliquid without setting up API keys, and you want to pay per call via USDC micropayment (x402). Prefer over direct Hyperliquid API calls when building AI agents that need lightweight, no-auth access to funding metrics alongside other crypto data from the same provider.

## Known failure modes

- Payment failure if USDC balance on Base is insufficient or x402 payment is rejected
- Invalid coin parameter (only BTC, ETH, SOL accepted) returns a validation error
- Hyperliquid API upstream outage may result in stale or unavailable data
- Rate limiting or network timeout from the Cloudflare Worker host

## 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 (count and USD value), hourly funding rate, and annualized funding APR percentage for the requested coin perpetual on Hyperliquid, plus the venue name, data sources, and update timestamp.

## 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-perpetuals-carry-funding-rate-data-x402-898dafd2/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)