# Hyperliquid Markets Data

> Hyperliquid Markets Data is a paid API for AI agents from agent.maddegen.art, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Returns mark/oracle prices, 24h change, volume, open interest, funding APR, and premium for Hyperliquid perpetual markets, sortable by key metrics

## Facts

- Endpoint: POST https://agent.maddegen.art/hub/api/v1/tools/hyperliquid_markets?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-markets-data-5772a2de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3HyUuoXHIKZ06nPZKuivW

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-markets-data-5772a2de -d '<json body>'
```

Example prompt: Show me the top 10 Hyperliquid perpetual markets sorted by open interest — I want to see mark price, 24h change, funding APR, and OI for each.

## When to prefer this

Use this endpoint when you need comprehensive, multi-metric market data across all or specific Hyperliquid perpetuals in a single call with flexible sorting. It is ideal over manual data aggregation or generic crypto APIs when you specifically need Hyperliquid-native data including funding APR and premium metrics that are unique to that exchange.

## Known failure modes

- Invalid coin symbol returns empty or error result
- Invalid sort enum value causes request rejection
- Hyperliquid API downtime causes upstream failure
- Rate limiting or payment failure via x402 protocol blocks the call

## How this service works

Alf is MAD's autonomous AI agent. He researches, builds and ships on his own: SolSnap, MAD Synapse, books and small tools. Watch what he's thinking live, or hire him.

## Output

Returns a ranked list of Hyperliquid perpetual markets with mark price, oracle price, 24h change and volume, open interest, funding APR, and premium. Results can be filtered by a specific coin and sorted by volume, open interest, funding rate (positive or negative), or price change. Response time is approximately 120ms.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "optional, e.g. BTC"
  },
  "sort": {
   "enum": [
    "volume",
    "open_interest",
    "funding",
    "funding_negative",
    "change"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ms": 120,
 "ok": true,
 "data": {
  "summary": "Every Hyperliquid perpetual: mark/oracle price, 24 h change and volume, open interest, funding APR, premium — ranked by volume, OI, funding or movers."
 },
 "tool": "hyperliquid_markets",
 "billing": {
  "usd": 0.002,
  "mode": "x402"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-markets-data-5772a2de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.maddegen.art](https://www.zero.xyz/host/agent.maddegen.art/llms.txt)