# Hyperliquid Live Long/Short Ratio Intelligence

> Hyperliquid Live Long/Short Ratio Intelligence 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-14).

Returns real-time long/short positioning ratios and sentiment data for Hyperliquid perpetuals markets, computed from first-party node fills data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/live/long-short
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-live-long-short-ratio-intelligence-96cd65f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JxGLJfF0Tsg5Q0f_9p3JY

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-live-long-short-ratio-intelligence-96cd65f5 -d '<json body>'
```

Example prompt: What's the current long/short ratio on Hyperliquid right now — are most traders positioned long or short on BTC perps, and how skewed is the sentiment?

## When to prefer this

Use this endpoint when you need real-time, first-party long/short positioning data specifically for Hyperliquid perpetuals markets — not aggregated cross-exchange data. Prefer this over third-party analytics tools when you want operator-neutral, self-computed sentiment that isn't reliant on external data providers. Ideal for agents monitoring Hyperliquid market structure, building contrarian signals, or tracking crowd positioning without requiring an account or API key (pay-per-call via x402).

## Known failure modes

- HTTP 402 if free quota is exhausted and no USDC payment is attached — must pay $0.001 per call via x402 protocol
- Empty or null response if no fills data is available for the requested market or time window
- Upstream Hyperliquid API unavailability may cause stale or missing data
- Invalid body shape returns a 400-level error — must conform to the operator's expected JSON payload structure
- Network timeouts if the node_fills ledger computation takes too long for broad queries

## How this service works

Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).

## Output

Returns the live aggregate long/short ratio for Hyperliquid perpetuals, including the proportion of traders or open interest on each side, directional bias metrics, and potentially cohort-level breakdowns — all computed from the operator's first-party node fills ledger.

## 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-live-long-short-ratio-intelligence-96cd65f5/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)