# Hyperliquid Position Lifecycle Analytics

> Hyperliquid Position Lifecycle Analytics is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Retrieves the full lifecycle of perpetual futures positions on Hyperliquid — entry, exit, and intermediate fills — for a given wallet or set of trades.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/analytics/lifecycle
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-position-lifecycle-analytics-42bd592a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5RvmuZtx0XDwWxN290FtY

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-position-lifecycle-analytics-42bd592a -d '<json body>'
```

Example prompt: Show me the full open-to-close lifecycle of the ETH-PERP position for wallet 0xABC...123 on Hyperliquid — I want to see all the fills, the entry and exit prices, and the total PnL.

## When to prefer this

Use this endpoint when you need the complete chronological lifecycle of one or more Hyperliquid perpetual positions — from open through all intermediate adjustments to close — computed from first-party node_fills data rather than a third-party aggregator. Ideal for per-position PnL attribution, liquidation analysis, or reconstructing trader behavior on Hyperliquid specifically.

## Known failure modes

- Wallet address not found or has no fills — empty result or 404
- Invalid request body shape — 400 Bad Request
- Insufficient USDC balance for x402 payment — HTTP 402
- Hyperliquid node data temporarily unavailable — 503 or timeout
- Time range too broad causing slow or truncated response

## 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 structured position lifecycle data including all fill events (entry, add, reduce, close), timestamps, prices, sizes, realized PnL, and liquidation flags for the queried wallet or position on Hyperliquid perpetual markets.

## 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-position-lifecycle-analytics-42bd592a/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)