# Hyperliquid Cohort Bias History

> Hyperliquid Cohort Bias History 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 historical cohort-level directional bias data for Hyperliquid perpetual traders, showing how different trader groups positioned over time

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/live/cohort-bias/history
- 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-cohort-bias-history-b5285a96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sa25BMV4QFJOtJmH7oCrU

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-bias-history-b5285a96 -d '<json body>'
```

Example prompt: Pull the historical cohort bias data from Hyperliquid for BTC perpetuals over the last 7 days — I want to see how different trader groups like retail and whales have been leaning long or short.

## When to prefer this

Choose this endpoint when you need time-series cohort-level sentiment and directional bias data derived directly from Hyperliquid's own fills ledger, without relying on third-party aggregators. It is ideal for building contrarian signals, backtesting crowd behavior, or studying how different trader size cohorts positioned historically on Hyperliquid perps. Prefer it over generic market data APIs when the specific Hyperliquid trader-cohort segmentation and fill-level accuracy matter.

## Known failure modes

- Invalid or missing body parameters return a 400 error
- Unsupported cohort type or market identifier returns an error response
- Payment of $0.001 USDC via x402 on Base is required; missing or failed payment returns 402
- Time range too large or unsupported may return an error or empty result
- Rate limiting or node data lag may cause stale or incomplete history

## 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 time-series dataset showing historical directional bias broken down by trader cohort on Hyperliquid perpetuals. Each record typically includes timestamps, cohort identifiers, net long/short ratios or bias scores, and aggregated positioning metrics derived from the 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-bias-history-b5285a96/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)