Your Risk Engine Is Blind Without Liquidation Scores

By @CoinMarketMan - 14-Jul-2026

Ваш Рушій Ризику Сліпий без Оцінок Ліквідаційного Ризику

4 липня ф'ючерси на вічні контракти на золото на Hyperliquid впали приблизно на $100 менш ніж за хвилину, перш ніж арбітражні боти відновили ціну. Трейдери, що тримали леверажні лонги протягом того 60-секундного вікна, були ліквідовані, не встигнувши й оком моргнути. Контракт зрештою самовідновився, але збиток вже було завдано.

Флеш-крашi не оголошують про себе заздалегідь. Вони трапляються у святкові вихідні, у вікна тонкої ліквідності та при розбіжностях оракула. Якщо ваш рушій ризику стежить лише за ціною та маржею, він летить наосліп, не бачачи тиску, що накопичується під поверхнею. Оцінка ліквідаційного ризику заповнює цю прогалину: вона показує, яка частка відкритого інтересу за певним активом наближається до примусового закриття, розбита за когортою трейдерів.

Ця стаття показує, як підключити ендпоінт ліквідаційного ризику HyperTracker до робочого рушія ризику. Наприкінці у вас буде Python-код, що опитує оцінки ризику, фільтрує за когортою та відправляє сповіщення до початку каскадів.

Що Насправді Вимірює Оцінка Ліквідаційного Ризику

Більшість дашбордів ризику відстежують коефіцієнти маржі. Це корисно для власних позицій, але нічого не говорить про ширший ринок. Оцінка ліквідаційного ризику перевертає питання: замість "чи ось-ось ліквідують мене" вона запитує "яка частина ринку ось-ось буде ліквідована?"

Наш ендпоінт ліквідаційного ризику повертає три поля для кожного активу в межах заданої когорти:

totalValue: загальний відкритий інтерес за цим активом у когорті
riskValue: доларова сума позицій, що знаходяться в межах 75% від порогу ліквідації
percentRisk: відношення вартості під ризиком до загальної експозиції

percentRisk 18% по ETH у когорті Whale означає, що майже п'ята частина всіх ETH-позицій Whale наближається до примусового закриття. Це випереджальний індикатор. Коли леверажні великі позиції скупчуються біля ліквідаційного порогу, відносно невеликий рух ціни може спровокувати каскад: примусові продажі тиснуть ціну вниз, що запускає нові ліквідації, що тисне ціну ще нижче.

Liquidation Risk Anatomy

Ендпоінт: Один Виклик, Всі Активи

Ендпоінт ліквідаційного ризику знаходиться за адресою:

GET /api/external/{segmentId}/assets/liquidation-risk

Передайте ID сегмента когорти як параметр шляху, і ви отримаєте ранжований список активів за ризиковою експозицією. Відповідь містить totalCount (кількість активів, за якими є позиції в цій когорті) та масив items з розбивкою ризику по кожному активу.

Ось повний список ID когорт, які можна запитати:

| Когорта | Тип | ID | |---|---|---| | Shrimp ($0-$250) | Розмір | 16 | | Fish ($250-$10K) | Розмір | 1 | | Dolphin ($10K-$50K) | Розмір | 2 | | Apex Predator ($50K-$100K) | Розмір | 3 | | Small Whale ($100K-$500K) | Розмір | 4 | | Whale ($500K-$1M) | Розмір | 5 | | Tidal Whale ($1M-$5M) | Розмір | 6 | | Leviathan ($5M+) | Розмір | 7 | | Money Printer (+$1M+) | PnL | 8 | | Smart Money (+$100K-$1M) | PnL | 9 | | Consistent Grinder (+$10K-$100K) | PnL | 10 | | Humble Earner ($0-$10K) | PnL | 11 | | Exit Liquidity (-$10K-$0) | PnL | 12 | | Semi-Rekt (-$100K до -$10K) | PnL | 13 | | Full Rekt (-$1M до -$100K) | PnL | 14 | | Giga-Rekt (нижче -$1M) | PnL | 15 |

Якість сигналу залежить від того, яку когорту ви запитуєте. Ліквідації Whale та Leviathan рухають ринки, бо обсяг примусового закриття достатньо великий, щоб впливати на ціну. Ліквідації Shrimp — це шум. Тому ваш рушій ризику повинен зважувати оцінки відповідно.

Cohort Risk Weight Comparison

Підключення: Мінімальний Монітор Ризику на Python

Ось робочий монітор ризику менш ніж у 50 рядках. Він опитує ендпоінт ліквідаційного ризику для когорт, що мають найбільше значення (Whale, Tidal Whale, Leviathan, Smart Money, Money Printer), обчислює зважену оцінку та відправляє сповіщення, коли агрегат перевищує визначений вами поріг.

import requests, time, json

API_BASE = "https://ht-api.coinmarketman.com/api/external"
TOKEN = "YOUR_JWT_TOKEN"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

# Когорти, що рухають ринки, з відносними вагами
WATCHED_COHORTS = {
    5: {"name": "Whale", "weight": 1.0},
    6: {"name": "Tidal Whale", "weight": 1.5},
    7: {"name": "Leviathan", "weight": 2.0},
    9: {"name": "Smart Money", "weight": 1.2},
    8: {"name": "Money Printer", "weight": 1.3},
}

ALERT_THRESHOLD = 15.0  # зважений percentRisk для спрацювання сповіщення
POLL_INTERVAL = 300     # 5 хвилин, відповідає оновленню API

def get_risk(segment_id):
    url = f"{API_BASE}/{segment_id}/assets/liquidation-risk"
    resp = requests.get(url, headers=HEADERS)
    resp.raise_for_status()
    return resp.json()["items"]

def compute_weighted_risk(coin):
    """Обчислює зважену оцінку ризику для одного активу по всіх когортах."""
    total_weight = 0
    weighted_sum = 0
    for seg_id, meta in WATCHED_COHORTS.items():
        assets = get_risk(seg_id)
        match = next((a for a in assets if a["coin"] == coin), None)
        if match:
            weighted_sum += match["percentRisk"] * meta["weight"]
            total_weight += meta["weight"]
    return weighted_sum / total_weight if total_weight else 0

def scan_and_alert():
    # Отримуємо одну когорту для списку активів
    all_assets = get_risk(5)
    for asset in all_assets:
        score = compute_weighted_risk(asset["coin"])
        if score >= ALERT_THRESHOLD:
            print(f"ALERT: {asset['coin']} weighted risk = {score:.1f}%")
            # Замініть на ваш вебхук, Telegram-бот або виклик Slack
            fire_alert(asset["coin"], score)

while True:
    scan_and_alert()
    time.sleep(POLL_INTERVAL)

Примітка щодо порогу та ваг вище. ALERT_THRESHOLD 15.0 та ваги когорт є ілюстративними відправними точками. Ви повинні відкалібрувати обидва показники на основі власного бектестингу та толерантності до ризику. HyperTracker класифікує гаманці за когортами. Він не встановлює конкретних порогів ризику або правил розміру позиції.

Фільтрація за Когортою: Чому Це Важливо

Наївний підхід полягав би в запиті всіх 16 когорт і усередненні їх оцінок ризику. Це гірше, ніж нічого, бо розмиває сигнал. Коли позиції Shrimp скупчуються біля ліквідації, ринок ледь це помічає. Коли під ризиком опиняються Leviathan, обсяг примусових продажів може спровокувати каскадні ліквідації, що породжують флеш-краші.

Наведений вище код вирішує це, призначаючи вищі ваги когортам із великими балансами. Але ви також можете побудувати окремі рівні сповіщень:

Рівень 1 (критичний): Leviathan, Tidal Whale, Money Printer. Позиції тут представляють найбільшу номінальну експозицію. Відправляйте сповіщення негайно при підвищеному ризику.
Рівень 2 (попередження): Whale, Small Whale, Smart Money. Значний обсяг, але менш ринкорушійний.
Рівень 3 (інформаційний): Все інше. Логуйте для досліджень та бектестингу, не сповіщайте в продакшені.

Така багаторівнева структура тримає канал сповіщень чистим. Рушій ризику, що сповіщає про все, по суті не сповіщає ні про що: оператор просто перестає звертати увагу.

Від Оцінок до Рішень: Що Повинен Робити Ваш Бот

Сирі оцінки ризику — це спостереження. Рішення — ось що відрізняє моніторинговий дашборд від рушія ризику. Ось як перетворити підвищений ліквідаційний ризик на автоматизовані дії:

Скорочуйте експозицію до початку каскаду

Якщо ваш бот тримає лонг по ETH, а зважена оцінка ліквідаційного ризику по ETH різко зростає вище порогу, це сигнал до скорочення розміру позиції або розширення стопа. Логіка проста: підвищений ризик означає, що пул леверажних позицій наближається до примусового закриття, а примусове закриття великих позицій може рушити ціну проти вас. Не потрібно передбачати напрямок. Просто потрібно стати меншим.

Визначайте точку відскоку після змиву

Каскадні ліквідації мають тенденцію до перельоту. Після змиву оцінки ліквідаційного ризику різко падають, бо позиції під ризиком уже закрито. Саме тоді часто починається відновлення до середнього. Якщо ваш бот відстежує оцінки ризику в часі, раптове падіння з високого до низького може бути сигналом того, що примусові продажі завершено і наближається відскок.

Зіставляйте з когортним байасом

Ліквідаційний ризик говорить вам, що тиск наростає. Когортний байас говорить, у якому напрямку. Якщо Leviathan переважно в лонгах і їхній ліквідаційний ризик зростає, це спрямований сигнал: примусові продажі, якщо вони відбудуться, будуть на лонговій стороні. Поєднуйте ендпоінт /assets/liquidation-risk з ендпоінтом /bias для більш повної картини.

Risk Engine Decision Tree

Реальний Контекст: Чому Це Важливо Зараз

Загальний відкритий інтерес Hyperliquid досяг $11,07 млрд 13 липня — найвищого рівня 2026 року. Більший відкритий інтерес означає більше позицій, більший леверадж і більший потенційний обсяг ліквідацій. З ростом платформи розрив між "моніторингом власної маржі" та "моніторингом маржі ринку" збільшується.

Флеш-краш золота 4 липня є класичним прикладом. Вічні контракти на золото впали приблизно на $100 менш ніж за хвилину через тонку святкову ліквідність і відхилення ціни оракула. Контракт швидко відновився, але всі, хто тримав леверажний лонг протягом того 60-секундного вікна, були ліквідовані до того, як встигли відреагувати. Рушій ризику, що відстежував оцінки ліквідаційного ризику по золоту, зафіксував би підвищений кластер позицій під ризиком ще до початку краша.

Цей патерн повторюється. Наприкінці травня 2026 року вічний контракт на pre-IPO акції SpaceX на Hyperliquid впав приблизно на 45% за близько 30 хвилин після проблеми з даними оракула, ліквідувавши $1,51 млн на 1 393 позиціях. Інший актив, той самий механізм: концентрований леверадж біля ліквідаційних порогів, тригерна подія і каскад. Єдина змінна — чи побачив це ваш рушій ризику заздалегідь.

Запуск у Продакшен

Мінімальний монітор вище підходить для прототипування. Для продакшена вам знадобляться деякі доповнення:

Постійний стан: Зберігайте історичні оцінки ризику в базі даних часових рядів (InfluxDB, TimescaleDB або навіть звичайний CSV). Це дозволяє бектестувати калібрування порогів і виявляти тренди.
Доставка через вебхук: Якщо ви на рівні Flow ($799/mo) або Stream ($1,999/mo), ви можете отримувати push-оновлення через вебхуки замість опитування. Це усуває 5-хвилинний розрив між опитуваннями і дає вам дані ризику щойно вони оновлюються.
Кореляція між активами: Коли ліквідаційний ризик одночасно зростає по кількох активах в одній когорті, це ширша подія делевереджингу. Ваш рушій ризику повинен виявляти корельовані стрибки і реагувати на агрегований сигнал, бо корельований стрибок небезпечніший за ізольований.
Шар дашборда: Передавайте дані ліквідаційного ризику в Grafana, Retool або кастомний фронтенд. Візуалізація оцінок ризику в часі, накладена на ціну, значно прискорює розпізнавання патернів порівняно з читанням логів.

Математика "будувати vs купувати": Побудова еквівалентної оцінки ліквідаційного ризику із сирих даних Hyperliquid означає прийом кожної позиції, обчислення наближеності до ліквідаційних порогів, класифікацію гаманців за поведінковими сегментами та агрегацію за когортою. Це конвеєр даних, на побудову якого йдуть місяці і який коштує $10 000+/місяць в обслуговуванні. API HyperTracker дає ту саму аналітику починаючи від $179/mo за одним REST-викликом.

Додайте оцінку ліквідаційного ризику до свого рушія ризику

16 поведінкових когорт. Ризикова експозиція на рівні активу. Один API-виклик. Починайте будувати на безкоштовному рівні.

Отримайте Ваш API-ключ

Ваш рушій ризику вже відстежує маржу та PnL. Оцінка ліквідаційного ризику додає шар, якого йому не вистачало: що решта ринку ось-ось буде змушена зробити. На ринку, де флеш-краші розгортаються за 60 секунд, ця передбачливість і є різницею між скороченням експозиції та перетворенням на Exit Liquidity.