# HL Open Interest

> HL Open Interest is a paid API for AI agents from earn-pulse.haiqingm58.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns current open interest and daily notional volume for BTC, ETH, and SOL on Hyperliquid's perpetual markets.

## Facts

- Endpoint: GET https://earn-pulse.haiqingm58.workers.dev/oi
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hl-open-interest-9e95cf4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_do7Mhu562xKRzMJCaU-3x

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 hl-open-interest-9e95cf4e
```

Example prompt: What's the current open interest and day notional on Hyperliquid for BTC, ETH, and SOL?

## When to prefer this

Use this endpoint when you need a quick, no-parameter snapshot of open interest and day notional specifically for BTC, ETH, and SOL on Hyperliquid. Prefer this over broader market data APIs when you specifically want Hyperliquid perpetuals data. If you need funding rates or mark prices, use the sibling HL Funding or HL Mark endpoints instead. Ideal for market condition checks, risk assessment before entering large trades, or daily derivatives briefings.

## Known failure modes

- Hyperliquid API unavailable — upstream data fetch fails, returns 5xx error
- Worker timeout if Hyperliquid data source is slow to respond
- Stale or cached data if the upstream feed has a delay
- Payment not included or invalid — x402 payment required error returned

## How this service works

Hyperliquid BTC/ETH/SOL open interest and day notional. No parameters.

## Output

Returns open interest (in USD or contracts) and day notional volume for BTC, ETH, and SOL perpetual markets on Hyperliquid. Data is returned as a structured object with per-asset breakdown of current open interest and the total notional traded within the current day.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hl-open-interest-9e95cf4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from earn-pulse.haiqingm58.workers.dev](https://www.zero.xyz/host/earn-pulse.haiqingm58.workers.dev/llms.txt)