# Annalist Hyperliquid Crowd States

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

Returns coins currently matching specific crowd-behavior states on Hyperliquid (e.g. up 50/100/200% in 7 days, funding extremes, attention spikes, new listings), with historical context on what happened next

## Facts

- Endpoint: GET https://api.annalist.dev/v1/crowd/states?utm_source=zero.xyz
- Price: $0.02/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-crowd-states-20545d9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-0JT17W48qPdTFu2FFlRj

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-crowd-states-20545d9c
```

Example prompt: Pull the Annalist crowd state data for Hyperliquid coins that are up 100% in the last 7 days — I want to see which assets are in that state and what historically happened next after they hit that level.

## When to prefer this

Choose this endpoint when you need real-time Hyperliquid crowd-behavior snapshots filtered by specific state categories (momentum, funding extremes, attention spikes, new listings) with cryptographic signing for trustless agent use. Prefer over generic market data APIs when you want crowd-state classification plus historical precedent context, and when operating in an x402 pay-per-call agentic workflow where signed data provenance matters.

## Known failure modes

- Invalid or missing 'state' enum value returns an error
- Payment not received via x402 protocol returns 402 Payment Required
- Rate limiting or quota exceeded may return 429
- If no coins currently match the requested state, the array may be empty
- Network or upstream Hyperliquid data unavailability may cause 503

## 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 JSON object containing a 'states' map keyed by the requested crowd state (e.g. 'up_100pct_7d'), with an array of coins matching that state including their symbol and 7-day return figure. Data is cryptographically signed by Annalist for verifiability.

## 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",
     "properties": {
      "state": {
       "enum": [
        "up_50pct_7d",
        "up_100pct_7d",
        "up_200pct_7d",
        "funding_top5",
        "funding_bottom5",
        "attention_spike_3x",
        "new_listing"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "states": {
    "up_100pct_7d": [
     {
      "coin": "XYZ",
      "return_7d": 1.4
     }
    ]
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hyperliquid-crowd-states-20545d9c/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)