# Hyperliquid Historical Open Interest

> Hyperliquid Historical Open Interest is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns historical open interest data for Hyperliquid perpetual markets, computed from first-party node fills ledger.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/markets/historical-oi
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-historical-open-interest-12afe6fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-yFKDJKvB_zkRCjULlptu

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-historical-open-interest-12afe6fe -d '<json body>'
```

Example prompt: Pull the historical open interest for BTC-PERP on Hyperliquid over the past 30 days so I can see how OI built up before the last big liquidation event.

## When to prefer this

Choose this endpoint when you need first-party, node-verified historical open interest data specifically from Hyperliquid perpetual markets. It is preferable over aggregators or third-party data providers because it is computed directly from Hyperliquid's own fills ledger, ensuring accuracy. Use it when building trading analytics, backtesting OI-based strategies, or monitoring market structure changes on Hyperliquid perps.

## Known failure modes

- Invalid or unsupported asset symbol returns an error or empty dataset
- Time range too large may result in truncated or paginated response
- Missing required body fields (asset, time range) causes a 400-level error
- Payment not received or x402 flow incomplete results in 402 Payment Required
- Hyperliquid node data lag may cause incomplete data for very recent timestamps

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

Returns a time-series array of open interest values for the requested Hyperliquid perpetual market, including timestamps and OI amounts (likely in USD or contract units), computed from Hyperliquid's own node fills ledger without third-party data sources.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-historical-open-interest-12afe6fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)