Skip to content

← hyperliquid

GET/api/v1/hyperliquid/liquidations

Hyperliquid liquidation radar with hot coin clusters

Enhanced liquidation detection across top Hyperliquid perpetuals. Identifies dominant side, hot coins, and large forced unwinds. Requires Pro plan or higher.

Authentication

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

See Authentication for details.

Responses

StatusDescriptionSchema
200Successful ResponseHyperliquidWrappedResponse

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/liquidations' \
  -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/liquidations", 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/liquidations",
  {
    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.