GET`/api/v1/hyperliquid/all`

All Hyperliquid data in one call - tier-filtered

Fetches all Hyperliquid collectors in parallel, then filters the response based on the authenticated user's tier. Tier gates (server-enforced, aligned on ``docs/strategy/hyperliquid_tiering_2026-06-04.md``) : - free/founding : market_overview + aggregate leaderboard/funding + liquidations health - pro : + full leaderboard / funding matrix / 24h liquidation radar + vaults + smart_money + funding chart + LS ratio + orderbook + funding_arb - performance : + HLP stats + clearinghouse (HIP-3 lives in its own canonical router ``/api/v1/hyperliquid/hip3/*``) Redis cache (P29-REDIS-CACHE-2026-06-01) : raw data cached with TTL 30s. Tier filtering happens server-side POST-cache so tier-agnostic key is safe (cf. cache.py SECURITY CONTRACT). resolve_user_tier still runs BEFORE every response - cache only avoids the slow fetch_all_hyperliquid() upstream call. Data refreshes every 15min via collector cron; 300s TTL = ~99.9% hit ratio.

Authentication

This endpoint requires the X-API-Key header or a valid Clerk JWT. Accepted schemes: HTTPBearer.

See Authentication for details.

Responses

Status	Description	Schema
`200`	Successful Response	`HyperliquidAllResponse`

See the standard error codes documented in the Error codes.

Code samples

Three ready-to-paste implementations. Replace $TRINITY_API_KEY with your API key (generated from the dashboard under Profile → API keys).

cURL

curl -X GET \
  'https://api.trinityinsights.io/api/v1/hyperliquid/all' \
  -H 'X-API-Key: $TRINITY_API_KEY'

Python

import os
import requests

BASE = "https://api.trinityinsights.io"
headers = {
    "X-API-Key": os.environ["TRINITY_API_KEY"],
}

response = requests.get(f"{BASE}/api/v1/hyperliquid/all", headers=headers, timeout=10)
response.raise_for_status()
data = response.json()

JavaScript

const apiKey = process.env.TRINITY_API_KEY;

const response = await fetch(
  "https://api.trinityinsights.io/api/v1/hyperliquid/all",
  {
    method: "GET",
    headers: {
      "X-API-Key": apiKey,
    },
  },
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}
const data = await response.json();

Institutional disclaimer

Trinity Insights is an educational and analytical tool. Values returned by this endpoint do not constitute investment advice. Trinity Insights is not a Crypto-Asset Service Provider (CASP) registered under MiCA Regulation (EU) 2023/1114. See the full disclaimer.