# Hyperliquid Cohort Tier Positions

> Hyperliquid Cohort Tier Positions 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 open perpetual positions for traders within a specific cohort tier on Hyperliquid, segmented by trader classification

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/cohorts/tier/positions
- 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-cohort-tier-positions-7deb167e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eYNdq2KGsVA5Q0wrgN7D2

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-cohort-tier-positions-7deb167e -d '<json body>'
```

Example prompt: Show me all open perpetual positions held by top-tier traders on Hyperliquid right now — I want to see what the highest-ranked cohort is currently long or short on.

## When to prefer this

Use this endpoint when you need to analyze open perpetual positions segmented by trader quality tier or cohort on Hyperliquid, especially when you want to identify what top-ranked or specific-tier traders are currently holding. Prefer this over generic leaderboard endpoints when position-level detail per cohort is required rather than just PnL rankings.

## Known failure modes

- Invalid or unrecognized cohort tier returns 400 Bad Request
- Missing required body fields returns 400 validation error
- Quota exhausted with no payment returns 402 Payment Required (x402 USDC pay-per-call)
- Upstream Hyperliquid node unavailable returns 503 or timeout
- Empty result set if no positions exist for the requested tier

## 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 open perpetual positions for traders in the specified cohort tier, including details such as asset, direction (long/short), position size, leverage, unrealized PnL, entry price, and liquidation price, segmented by trader quality tier as computed from Hyperliquid'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-cohort-tier-positions-7deb167e/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)