# Annalist Smart Money Market Overview

> Annalist Smart Money Market Overview 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 aggregated positioning data for Hyperliquid's most profitable traders across all perpetual markets, including overall net direction, top long/short coins, biggest 24h shifts, and smart money vs. crowd divergences.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/smart/market?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-smart-money-market-overview-5d12035c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gm16czefS1HyM8RvIz2Hz

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-smart-money-market-overview-5d12035c
```

Example prompt: Can you pull up where the most profitable Hyperliquid traders are positioned right now across all perps — I want to see which coins they're most long and short on, any big moves in the last 24 hours, and where they're going against the crowd?

## When to prefer this

Choose this endpoint when you need a broad, market-wide snapshot of smart money positioning across all Hyperliquid perpetuals at once. It is the right choice for daily briefings, pre-trade sentiment checks, or scanning for smart money vs. crowd divergences across the entire market. For single-perp deep dives, use the per-coin Annalist endpoint instead. For polling incremental changes, use the events-since-timestamp endpoint.

## Known failure modes

- API returns 402 Payment Required if the x402 payment header is missing or payment fails
- Data may lag if Hyperliquid on-chain data is delayed
- Response may be empty or sparse if the cohort has minimal recent activity
- Rate limiting may apply for high-frequency polling use cases

## 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 market-wide snapshot of aggregated positioning for Hyperliquid's most profitable trader cohort: overall net long or short bias, ranked lists of coins with the largest net long and net short exposure, the biggest 24-hour changes in positioning, and coins where smart money diverges from the crowd. All figures are signed and aggregated (no individual-level data). Cohort definition is included in the response. Not investment advice.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "net_share": 0.12,
   "cohort_size": 200,
   "most_net_short": [
    {
     "coin": "XYZ",
     "net_usd": -4200000
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-smart-money-market-overview-5d12035c/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)