# Hyperliquid Trader Cohort Tier Classification

> Hyperliquid Trader Cohort Tier Classification 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).

Classifies Hyperliquid perpetual traders into cohort tiers based on their trading behavior and performance metrics

## Facts

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

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-trader-cohort-tier-classification-8db4872a -d '<json body>'
```

Example prompt: What cohort tier is wallet 0x1234abcd...ef on Hyperliquid — is it classified as a retail, mid, or whale-level perpetuals trader based on their fill history?

## When to prefer this

Choose this endpoint when you need to classify or segment a specific Hyperliquid perpetuals trader into a behavioral cohort tier using first-party on-chain fill data. Prefer this over generic leaderboard or position endpoints when the goal is trader segmentation or cohort analysis rather than raw PnL or rankings. Ideal for risk profiling, targeting specific trader types, or building cohort-aware analytics pipelines on Hyperliquid.

## Known failure modes

- Invalid or malformed wallet address returns 400 error
- Unknown wallet with no trading history may return empty or default tier
- HTTP 402 returned when free quota is exhausted — requires x402 micropayment in USDC to proceed
- Malformed POST body or missing required fields returns validation error
- Network or node data lag may cause stale tier assignments

## 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 cohort tier classification for the specified trader wallet, indicating which segment or tier the trader belongs to based on their perpetual trading activity, fill volume, and behavioral patterns derived from the 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-trader-cohort-tier-classification-8db4872a/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)