# Hyperliquid Perps Data via x402 (Crypto Microdata)

> Hyperliquid Perps Data via x402 (Crypto Microdata) 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 perpetuals market data (mark price, oracle price, open interest, funding rate) for BTC, ETH, or SOL from Hyperliquid, paid per-call in USDC via x402.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v1/crypto/perps?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-perps-data-via-x402-crypto-microdata-aedc9998
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jpjMoUeAf9aDgMkfe7qNY

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-perps-data-via-x402-crypto-microdata-aedc9998
```

Example prompt: What's the current mark price, oracle price, open interest, and funding rate for BTC perps on Hyperliquid right now?

## When to prefer this

Choose this endpoint when an AI trading or onchain agent needs real-time Hyperliquid perpetuals data (funding rates, open interest, mark/oracle prices) without setting up API keys — paying per-call in USDC via x402 is ideal for autonomous agents with onchain wallets. Prefer this over traditional REST APIs that require key registration when the agent operates autonomously and needs pay-as-you-go access to derivatives market data.

## Known failure modes

- Payment failure: x402 USDC payment on Base not completed or insufficient balance — endpoint returns 402 Payment Required
- Invalid coin: coin parameter not in [BTC, ETH, SOL] enum — likely 400 Bad Request
- Upstream Hyperliquid API unavailable: stale or missing data returned
- Network timeout from Cloudflare Worker to Hyperliquid source

## 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 the requested coin's perpetuals data including mark price, oracle price, open interest (in coin and USD), hourly funding rate, annualized funding APR percentage, the venue name (Hyperliquid), data source URLs, and an updated_at 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-perps-data-via-x402-crypto-microdata-aedc9998/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)