# Hyperliquid Perpetuals Ticker History

> Hyperliquid Perpetuals Ticker History 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 mark price, oracle price, open interest, hourly funding rate, and annualized funding APR for BTC, ETH, or SOL perpetuals on Hyperliquid, paid per-call via x402 USDC micropayment.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/perpetuals/ticker-history?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-ticker-history-4e7f74e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ce8_t3e1NrvpdHVWTsTow

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-ticker-history-4e7f74e3
```

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

## When to prefer this

Choose this endpoint when an AI trading agent needs real-time Hyperliquid perpetuals data — specifically mark/oracle price divergence, funding rates, and open interest — without managing API keys. The x402 micropayment model makes it ideal for autonomous agents that pay per call in USDC on Base. Prefer this over general market data APIs when Hyperliquid-specific funding and OI data is required for derivatives strategy decisions.

## Known failure modes

- Unsupported coin symbol returns error (only BTC, ETH, SOL are valid enum values)
- x402 payment failure if USDC balance on Base is insufficient or payment is rejected
- Hyperliquid API upstream outage may cause stale or missing data
- Rate limiting or worker timeout on the Cloudflare Workers backend
- Missing coin query param defaults to BTC — agent may silently get BTC data when another coin was intended

## 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

A JSON object containing for the requested coin: mark_px (mark price), oracle_px (oracle price), open_interest (in coin units), funding_hourly (hourly funding rate as decimal), funding_apr_pct (annualized funding rate as percentage), and open_interest_usd (open interest in USD). Also includes the venue name ('hyperliquid'), data sources array, and an updated_at ISO 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-ticker-history-4e7f74e3/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)