# Annalist Hyperliquid Perp Crowd State Analyzer

> Annalist Hyperliquid Perp Crowd State Analyzer is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns crowd and hype state analysis for a Hyperliquid perpetual, including funding metrics, open interest changes, premium, Wikipedia attention, and historical base rates for each crowd state

## Facts

- Endpoint: GET https://api.annalist.dev/v1/crowd/perp?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-hyperliquid-perp-crowd-state-analyzer-c0923894
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z0fqUk8hw_moD1Tswy4_O

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 annalist-hyperliquid-perp-crowd-state-analyzer-c0923894
```

Example prompt: Before I trade SOL perp on Hyperliquid, check if it's in a crowded or hype state and tell me what historically happened next — funding percentile, open interest changes, and base rates for each active crowd state.

## When to prefer this

Use this endpoint when you need a pre-trade crowd/hype risk assessment specifically for Hyperliquid perpetuals, including funding rate context, open interest momentum, and historical base rates for identified crowd states. Prefer this over generic market data APIs when you want regime-aware context (crowded long, hype, etc.) with quantified historical outcomes rather than raw price feeds.

## Known failure modes

- Invalid or unsupported coin symbol returns an error (symbol not listed on Hyperliquid)
- Network timeout or upstream data unavailability from Hyperliquid
- Payment failure via x402 protocol resulting in 402 response before data is returned
- Insufficient historical data for a newly listed perp may yield sparse base rate statistics

## How this service works

Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.

## Output

Returns a signed JSON payload with: 7-day price move, hourly funding rate, funding APR, funding percentile vs coin's own 90-day history and vs all perps, open interest and its 24h/7d percentage change, premium, Wikipedia page attention, list of currently active crowd states, and for each state its historical base rates including sample size, median 7-day/30-day/90-day returns, and return spread.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "coin": "SOL",
   "states": [],
   "return_7d": 0.12,
   "base_rates": {},
   "funding_apr": 0.11
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hyperliquid-perp-crowd-state-analyzer-c0923894/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.annalist.dev](https://www.zero.xyz/host/api.annalist.dev/llms.txt)