# Annalist Market-Wide Crowd State

> Annalist Market-Wide Crowd 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-13).

Returns market-wide crowding metrics for all Hyperliquid perpetuals, including breadth of 7-day moves, funding rate extremes, total open interest, BTC/ETH funding percentiles, and Wikipedia attention to crypto.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/crowd/market?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-market-wide-crowd-state-d5bff987
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YHEJRpEud4SQOhGUOicc2

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-market-wide-crowd-state-d5bff987
```

Example prompt: Give me the current market-wide crowding snapshot on Hyperliquid — how many perps are up 50% or 100% this week, where BTC and ETH funding percentiles stand, what total open interest looks like, and whether Wikipedia crypto attention is elevated.

## When to prefer this

Use this endpoint when you need a macro-level, market-wide view of crowding on Hyperliquid rather than a single-perp assessment. Prefer it over per-asset endpoints when making portfolio-level decisions, assessing systemic risk, or checking whether a broad hype cycle is underway. It is the right choice when you want a signed, aggregated signal combining price breadth, funding extremes, open interest, and off-chain sentiment (Wikipedia) in a single call.

## Known failure modes

- Payment not included or insufficient (x402 payment required, $0.01 USDC)
- Hyperliquid data feed temporarily unavailable causing stale or missing metrics
- Rate limiting if called too frequently
- Invalid request format (method must be GET)

## 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 signed JSON response containing: breadth of 7-day price moves across all Hyperliquid perps, count/share of perps up 50%+, 100%+, and 200%+ in a week, share of perps with funding in their own top or bottom 5% historically, total market open interest and its 24-hour change, BTC and ETH funding rate percentiles, and a Wikipedia attention metric for cryptocurrency. Data is cryptographically signed and intended for informational/analytical use.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "BTC": {
    "funding_7d_pct_own_365d": 0.6
   },
   "median_return_7d": 0.01,
   "count_up_100pct_7d": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-market-wide-crowd-state-d5bff987/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)