# Hyperliquid Smart Money Bias & Recommendations API

> Hyperliquid Smart Money Bias & Recommendations API is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns long/short directional bias per Hyperliquid market with a composite score derived from funding rate, open interest, and whale positioning signals

## Facts

- Endpoint: GET https://whaletape.xyz/recommendations
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-smart-money-bias-recommendations-api-5877becf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ChfaPGxFMW3mcUujmDWEc

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-bias-recommendations-api-5877becf
```

Example prompt: What's the current smart money bias score for all Hyperliquid markets — are whales and funding rate pointing long or short, and what are the main reasons behind the signal?

## When to prefer this

Choose this endpoint when you need a single pre-computed composite directional bias (long/short) per market that merges funding rate, open interest, and whale positioning into one score with human-readable reasons — rather than fetching those three signals separately and computing your own heuristic. Prefer it over raw flow or leaderboard endpoints when you want a ready-to-use bias recommendation rather than raw data.

## Known failure modes

- No market filter available — returns all markets by default; no per-market query parameter documented
- Upstream Hyperliquid data delay may cause stale signals during high-volatility periods
- Score may not reflect sudden market moves between API calls
- Payment failure (x402 protocol) if USDC balance is insufficient
- HTTP 402 if payment not attached or rejected by facilitator

## How this service works

Long or short bias per market with a score and the reasons behind it: funding, open interest and whale positioning combined. Heuristic, not advice

## Output

A list of Hyperliquid markets each with a long or short directional bias label, a composite heuristic score, and a breakdown of the contributing reasons: current funding rate signal, open interest dynamics, and whale positioning. Explicitly marked as heuristic, not financial advice.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "disclaimer": "heuristic derived from public data; NOT financial advice",
  "updated_at": "2026-08-23T01:39:43.769674+00:00",
  "recommendations": [
   {
    "side": "SHORT",
    "score": -3,
    "symbol": "VVV",
    "funding": 0.0001040384,
    "mark_px": 16.877,
    "reasons": [
     "funding high (+0.0104%/h): long side crowded",
     "whales 100% short ($888,018 total)"
    ],
    "oi_change": 0.0001966955568541902,
    "px_change": 0.0002963489805594479,
    "confidence": "media",
    "day_volume": 19628676.50290999,
    "asset_class": "crypto"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-bias-recommendations-api-5877becf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whaletape.xyz](https://www.zero.xyz/host/whaletape.xyz/llms.txt)