# Hyperliquid Live Long/Short Ratio

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

Returns real-time long/short position ratio and sentiment data for Hyperliquid perpetual markets, derived from first-party node fills ledger data.

## Facts

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

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-bf66bebd -d '<json body>'
```

Example prompt: What's the current live long/short ratio on Hyperliquid perp markets — are traders predominantly positioned long or short right now, and by how much?

## When to prefer this

Choose this endpoint when you need real-time, first-party long/short sentiment data specifically for Hyperliquid perpetual markets, computed directly from on-chain node_fills rather than aggregated third-party sources. Prefer this over generic crypto sentiment APIs when you need Hyperliquid-native positioning accuracy, and over Hyperliquid's own public API when you need enriched computed metrics beyond raw data. Best suited for agents building trading signals, sentiment dashboards, or risk monitoring around Hyperliquid perp markets.

## Known failure modes

- Payment not included or insufficient USDC via x402 on Base — returns 402 Payment Required
- Malformed POST body — returns 400 Bad Request
- Node_fills ledger temporarily unavailable — may return 503 or stale data
- Rate limits or network congestion on Base causing payment verification delays
- Invalid or missing required body fields — returns validation error

## 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 the current long/short ratio breakdown for Hyperliquid perpetual markets, including the percentage of open positions that are long versus short, derived from the operator's own node_fills ledger. May include per-asset breakdowns, aggregate sentiment metrics, and open interest distribution between longs and shorts.

## 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-bf66bebd/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)