# Hyperliquid Smart Money Positioning Signal

> Hyperliquid Smart Money Positioning Signal is a paid API for AI agents from api.solenrich.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Scans the Hyperliquid leaderboard for consistent directional traders and aggregates their live positions into a per-coin consensus with long/short counts, net notional, bias, and conviction metrics.

## Facts

- Endpoint: POST https://api.solenrich.com/entrypoints/hyperliquid-smart-money/invoke
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-smart-money-positioning-signal-3cd2e545
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_83bU3XJ7870C5hERpUIxy

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 hyperliquid-smart-money-positioning-signal-3cd2e545 -d '<json body>'
```

Example prompt: What's the smart money consensus on ETH right now on Hyperliquid — pull the top 15 traders and show me their positioning in JSON format?

## When to prefer this

Use this endpoint when you need a crowd-sourced directional signal from proven Hyperliquid traders, filtered for quality (no market makers, HFT, or dust accounts). Best for gauging positioning sentiment on a specific coin or the broad market before entering a perp trade. Not a trade signal — use as a regime-aware crowding indicator.

## Known failure modes

- Invalid or unrecognized coin symbol returns error or empty market result
- top_traders value outside 1-25 range causes validation error
- Leaderboard data temporarily unavailable due to Hyperliquid API downtime
- No qualifying traders found after HFT/dust/mega account filtering returns empty consensus
- Consensus data may be stale if Hyperliquid positions haven't refreshed

## How this service works

Where Hyperliquid smart money is positioned. Scans the HL leaderboard, excludes market-makers/HFT and dust/mega accounts, keeps consistent directional traders (week+month PnL > 0), then aggregates their live positions into a per-coin consensus (long/short counts, net notional, bias, conviction) plus a top-trader drill-down ranked by month PnL. A positioning signal, not a trade: consensus is often crowded and regime-dependent.

## Output

Returns a per-coin consensus object including long count, short count, net notional, directional bias, and conviction level, plus a ranked drill-down of top traders by monthly PnL showing their individual live positions on Hyperliquid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "format": {
   "enum": [
    "json",
    "llm",
    "both"
   ],
   "type": "string",
   "default": "json"
  },
  "market": {
   "type": "string",
   "maxLength": 12,
   "minLength": 1,
   "description": "Optional single-coin focus, e.g. HYPE/BTC/ETH"
  },
  "top_traders": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1,
   "description": "How many top traders to include (default 10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "output": {
   "briefing": "string (llm format) or object (json format)"
  },
  "run_id": "uuid",
  "status": "succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-positioning-signal-3cd2e545/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solenrich.com](https://www.zero.xyz/host/api.solenrich.com/llms.txt)