Методология рынков

Источники данных#

Каталог использует официальный mainnet Info endpoint Hyperliquid. Сервер запрашивает полный основной perpetual DEX, spot metadata с контекстами, список HIP-3 DEX и metadata каждого DEX. Свечи, funding history и L2 book загружаются отдельными официальными методами с ограниченным кэшем. Рыночная цена, объём или funding не берутся с другого affiliate-сайта.

API отвечает за параметры торгового инструмента, но не за редакционное описание базового актива. Назначение криптоактива проверяется по документации проекта, компания — по корпоративному сайту и investor relations, индекс — по provider и methodology, товар — по benchmark и oracle source. Если этих источников нет, ticker не превращается в догадку.

Типы рынков#

Основной perpetual DEX содержит бессрочные контракты Hyperliquid. Spot означает обмен одного токена на другой с появлением купленного актива на spot-балансе. HIP-3 — builder-deployed perpetual: его идентичность включает и DEX, и coin, поэтому одинаковые ticker в двух DEX считаются разными инструментами. Outcome markets представляют отдельные полностью обеспеченные исходы и не используют perpetual-layout.

Такое разделение определяет текст и инструменты страницы. Spot не показывает funding и ликвидацию. Perpetual не называется покупкой базового токена. Equity-контракт HIP-3 не выдаётся за владение акцией. Outcome не получает плечо, stop-loss и liquidation calculator.

Mid, mark и oracle#

Mid — середина между лучшим bid и ask, если обе стороны существуют. Это удобный ориентир стакана, но не обещание исполнения. Mark — расчётная цена perpetual, используемая для состояния маржи, нереализованного PnL и ликвидации. Oracle — внешний ценовой ориентир, который участвует в механике perpetual и funding. На странице эти значения подписаны отдельно.

Изменение за 24 часа считается через текущий ценовой ориентир и prevDayPx. При отсутствующем или нулевом предыдущем значении процент не выводится: интерфейс не подставляет 0% и не показывает некорректное числовое значение. Для spot reference price также не подменяет фактические цены заявок.

Funding, OI и объём#

Funding из Info endpoint хранится как decimal string с подтверждённой basis. Для основного API это часовая ставка; APR показывается только после явной проверки единицы. Open interest в долларах является расчётом: количество базового актива умножается на mark price. Подпись прямо говорит, что это расчётный долларовый OI.

24-часовой объём относится к конкретному рынку Hyperliquid, а не ко всему мировому обороту актива. Глубина стакана считается только в обозначенной полосе 0,5% или 1% и не называется общей ликвидностью рынка.

Spot identity и supply#

Spot metadata связывается с контекстом по coin, а base и quote разрешаются через token indices. Массивы metadata и contexts могут иметь разную длину, поэтому позиционное объединение запрещено. Контекст без пары или ссылка на отсутствующий token index отклоняются и попадают в диагностику.

Отдельный asset entity определяет природу base-токена: нативный, wrapped, stablecoin, tokenized equity или index, synthetic, receipt либо unknown. Расчётная капитализация разрешена только для подтверждённого native crypto, когда circulatingSupply означает предложение того же нативного актива. Для wrapped, tokenized, synthetic и unknown supply не интерпретируется как капитализация underlying.

Техническое поле isCanonical показывается как «Канонический токен HyperCore». Оно не связано с canonical URL страницы.

HIP-3 и underlying#

Для HIP-3 сначала запрашивается список DEX, затем один пакет metadata/context на каждый DEX. Coin хранится вместе с префиксом, например xyz:CRCL; удаление xyz создало бы коллизию и неверную сущность. Категория выбирает отдельный профиль crypto, equity, index, commodity или FX.

Редакционный профиль подтверждает underlying, provider, компанию или benchmark. Для equity нужны корпоративный источник и investor relations, для индекса — provider и methodology, для товара — benchmark и oracle source. Generic-текст о внутреннем процессе не заменяет описание самого инструмента.

Outcome markets#

Outcome metadata имеет собственную модель: вопрос, два исхода, цены от 0 до 1, время закрытия и правила расчёта. Эти страницы не используют funding, плечо, mark/oracle perpetual, long/short guide и liquidation calculator. Вместо них доступен payout calculator.

Технические записи без понятного вопроса и settlement rules скрываются из публичного каталога, не получают коммерческий CTA и остаются noindex. Все outcome pages по умолчанию noindex до отдельного ручного одобрения.

Получение и проверка#

Фоновая задача делает пакетные запросы: один для основного perpetual DEX, один для spot и по одному для HIP-3 DEX. Ответы проходят Zod validation, таймаут, ограниченный retry и circuit breaker. Несовпадение длины metadata/context у perpetual отклоняет обновление целиком, чтобы данные одного актива не сдвинулись на другой.

PostgreSQL хранит стабильные market keys, историю slug, snapshots, свечи, profiles и lifecycle. Redis обслуживает короткий оперативный кэш и lock, не позволяющий двум ingestion jobs выполнять одну работу одновременно. Страница читает сохранённый снимок; она не запрашивает весь API заново при каждом просмотре.

Freshness и stale state#

Время получения данных хранится отдельно от редакционной даты. Если обновление не прошло, предыдущий корректный снимок сохраняется и получает stale marker. Значения не заменяются нулями. Пользователь видит время последнего успешного обновления без большой аварийной плашки.

Sitemap lastmod не меняется с каждой ценой. Для live data используется dataUpdatedAt, а lastmod отражает изменение профиля, спецификации, статуса, canonical или факта делистинга.

Quality gate#

Каждый новый рынок сначала получает стабильный технический URL со статусом candidate и noindex, follow. Quality score учитывает полноту API, проверенную identity, глубину редакционного профиля, первичные источники, историю, уникальный FAQ и visual, правильные инструменты, trade URL и similarity.

Даже оценка 80 из 100 не включает индекс автоматически. Одновременно нужны approved editorial profile, ручная запись в allowlist, подтверждённая identity, свежие данные, отсутствие placeholder-текста и сходство ниже 25%. Metadata, HTTP header и market sitemap используют один модуль решения.

Новые рынки и делистинг#

Новый API ticker создаёт candidate page и начинает накапливать данные. Редактор затем определяет сущность, собирает источники и проверяет торговый маршрут. Cron не может повысить статус до indexable.

Если активный рынок исчез, система сохраняет запись и отключает direct trade CTA до проверки официального объявления. Подтверждённый делистинг убирается из sitemap, получает noindex и дату события. При очевидной замене используется 301; без замены после переходного периода возможен 410.

Исправление ошибок#

Рыночная сущность может быть временно закрыта от индексации вручную. Исправление проходит тем же путём: первичный источник, обновлённый профиль, повторная проверка trade URL, similarity и quality gate. Дата проверки не обновляется автоматически без фактической сверки.

Если вы нашли неверный underlying, тип актива или торговый маршрут, отправьте URL и первичный источник на contact@hyperliquid.guru. До подтверждения спорное утверждение будет удалено либо переведено в нейтральный noindex-режим.