# Hyperliquid Closed Positions Recent

> Hyperliquid Closed Positions Recent 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).

Retrieves recently closed perpetual trading positions from the Hyperliquid DEX, computed from first-party node fill data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/analytics/closed-positions/recent
- 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-closed-positions-recent-f6bdec58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3mD0lhGo7UWTyYnzyaaJd

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-closed-positions-recent-f6bdec58 -d '<json body>'
```

Example prompt: Pull the most recently closed perpetual positions from Hyperliquid — I want to see what trades just closed, including fill details and PnL, computed from first-party node data.

## When to prefer this

Choose this endpoint when you need recently closed perpetual position data from Hyperliquid sourced entirely from first-party node fills (not third-party data aggregators). Prefer it for position lifecycle analysis, PnL tracking on closed trades, or feeding downstream analytics on Hyperliquid trader behavior. It is especially suited for agent workflows that need pay-per-call access with no API key setup.

## Known failure modes

- HTTP 402 if free quota is exhausted and no x402 USDC payment is attached
- Empty result set if no positions closed in the requested window
- Malformed request body returns 400 if required fields are missing
- Upstream Hyperliquid API outage may cause degraded or stale results
- Invalid wallet address format returns an error or empty 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 a list of recently closed perpetual positions on Hyperliquid, including fill-level detail, entry/exit prices, realized PnL, position size, asset, and lifecycle timestamps — all sourced from the operator's own 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-closed-positions-recent-f6bdec58/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)