# Annalist Smart Money Perp Positioning

> Annalist Smart Money Perp Positioning 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 aggregated smart-money positioning data for a single Hyperliquid perpetual — long/short wallet counts, USD exposure, net delta, concentration, leverage, and comparison with crowd funding/price dynamics.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/smart/perp?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-smart-money-perp-positioning-a1481294
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5HOZg0LrwMM7cnEu8df4H

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-perp-positioning-a1481294
```

Example prompt: Before I open a long on the ETH perp on Hyperliquid, can you check how the most profitable traders there are positioned — are they net long or short, how exposed are they in USD, and is the trade crowded against them?

## When to prefer this

Use this endpoint when you need to understand how a curated cohort of Hyperliquid's most profitable traders are positioned in a specific perpetual before executing a trade or forming a directional view. Prefer this over generic open-interest or funding-rate feeds when you want smart-money-specific positioning context, concentration risk signals, and crowd-vs-smart-money divergence — all aggregated and signed, without exposing individual wallets.

## Known failure modes

- Unknown or unsupported coin symbol returns an error or empty result
- Network timeout if Hyperliquid data feed is unavailable
- Stale data if the underlying on-chain data pipeline is lagging
- Payment failure (x402) if USDC balance is insufficient for the $0.01 call cost
- Coin symbol case sensitivity issues (e.g. 'btc' vs 'BTC')

## 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 aggregated data for the requested perp symbol: number of smart-money wallets long vs short (out of a 200-wallet cohort), their total long, short, and net USD exposure, 24-hour change in exposure, concentration metrics (largest wallet's share of cohort exposure, trader count), average leverage settings, the cohort's share of total open interest, and crowd comparison signals (current funding rate, 7-day price move). May flag when smart money is broadly positioned against a crowded directional move. No individual wallet addresses are returned.

## 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": "SOL",
   "flags": [],
   "net_usd": 12500000,
   "net_share": 0.42,
   "traders_long": 41,
   "traders_short": 18
  }
 }
}
```

## More

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