# Annalist Hyperliquid Perp Full State

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

Returns full perpetual market intelligence for a Hyperliquid coin — crowd positioning state, smart money net share, and liquidation flags with historical context — as cryptographically signed data.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/perp/full?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-hyperliquid-perp-full-state-c063c18b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__-S3JArpfrlZjEHVhw1bJ

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-full-state-c063c18b
```

Example prompt: Pull the full Hyperliquid perp intelligence for BTC — crowd positioning, smart money net share, liquidation flags, and what historically followed similar conditions — and give me the signed data snapshot.

## When to prefer this

Choose this endpoint when you need a comprehensive, single-call snapshot of Hyperliquid perpetual market intelligence — crowd positioning, smart money flows, and liquidation context — with cryptographic signing for data integrity. Prefer it over raw Hyperliquid API calls when you need the historical-analog context (what happened next) or when your agent workflow requires verifiable signed data payloads. It is specifically suited for DeFi trading agents that need actionable, pre-analyzed signals rather than raw order book data.

## Known failure modes

- Invalid or unsupported coin symbol returns an error — must use exact Hyperliquid perp ticker (e.g. BTC not BTCUSDT)
- Payment failure via x402 protocol results in 402 response before data is returned
- Hyperliquid data unavailability may result in empty arrays for crowd states or flags
- Stale or delayed underlying data if Hyperliquid feed is lagging
- Rate limit or quota exhaustion returning 429 or similar error

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

A JSON object containing: the queried coin symbol, an array of crowd state snapshots, a smart money object with net_share (fraction of open interest held by smart money wallets), and a liquidations object with flags describing recent liquidation events and historical analogs — all wrapped in a cryptographic signature for data integrity verification.

## 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": "BTC",
   "crowd": {
    "states": []
   },
   "smart_money": {
    "net_share": 0.12
   },
   "liquidations": {
    "flags": []
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hyperliquid-perp-full-state-c063c18b/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)