# Annalist HLP Vault State

> Annalist HLP Vault State 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-14).

Returns current Hyperliquid HLP vault metrics including APR, net USD exposure, largest short positions, and account value — signed data delivered via x402 micropayment.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/vaults/hlp?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-hlp-vault-state-8fe03951
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ifZPc0qhcLw0DVQgqQSh5

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-hlp-vault-state-8fe03951
```

Example prompt: What does the Hyperliquid HLP vault look like right now — what's the APR, total account value, and which coin has the biggest short position?

## When to prefer this

Choose this endpoint when you need real-time, signed Hyperliquid HLP vault metrics — particularly APR, net positioning, and top short exposure — and require cryptographic proof of data integrity for agent workflows. Prefer this over scraping Hyperliquid directly when you need verifiable, pay-per-call data in an agentic pipeline that already handles x402 micropayments.

## Known failure modes

- 402 Payment Required if x402 payment header is missing or insufficient — must include 0.01 USDC payment
- Stale data if Hyperliquid API is temporarily unavailable upstream
- Invalid or malformed response if the vault identifier is incorrect
- Network timeout if Annalist infrastructure is under load

## 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 with: apr (annual percentage rate as a decimal), net_usd (net dollar exposure, negative = net short), most_short (array of coin symbols and their net USD short exposure), and account_value_usd (total vault AUM). Data is cryptographically signed by Annalist for agent verifiability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "apr": 0.03,
   "net_usd": -12000000,
   "most_short": [
    {
     "coin": "BTC",
     "net_usd": -8000000
    }
   ],
   "account_value_usd": 380000000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hlp-vault-state-8fe03951/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)