# Hyperliquid Data - Trader Cohorts Summary

> Hyperliquid Data - Trader Cohorts Summary 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 a summary breakdown of Hyperliquid perpetual traders segmented into behavioral cohorts (e.g. whales, retail, liquidation-prone) based on fill and position lifecycle data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/cohorts/summary
- 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-data-trader-cohorts-summary-5edabdc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K0dKw-L0NiUlPBf44wZ-W

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-data-trader-cohorts-summary-5edabdc6 -d '<json body>'
```

Example prompt: Give me a summary of the different trader cohorts on Hyperliquid perps — I want to see how the population breaks down by segment, like whales, retail, and high-liquidation-risk traders.

## When to prefer this

Choose this endpoint when you need a population-level segmentation of Hyperliquid traders by behavioral cohort rather than individual wallet lookups. It is uniquely suited for market structure research, risk monitoring across trader classes, and understanding the composition of Hyperliquid's perp trading base. Prefer it over individual fill or leaderboard endpoints when you want aggregate cohort-level insights in a single call.

## Known failure modes

- Malformed POST body returns 400 with schema validation error
- Payment not submitted or insufficient USDC triggers x402 payment-required response
- Cohort filter parameters outside supported range return empty or error response
- Hyperliquid public info API downtime may cause stale or incomplete cohort data
- Rate limiting or node sync lag may produce delayed results

## 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

A structured JSON response containing aggregated statistics for each identified trader cohort on Hyperliquid, including segment labels, trader counts, volume metrics, position data, and risk indicators derived from the operator's 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-data-trader-cohorts-summary-5edabdc6/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)