Данные о ставке финансирования (фандинге) могут описывать ставку, опубликованную для контракта, либо фактические выплаты, зафиксированные по конкретному счёту. Они отвечают на совершенно разные вопросы. В этом пошаговом руководстве используется публичная документация Hyperliquid и запросы на чтение истории BTC, проверенные 27 сентября 2026 года. Поля эндпоинтов и правила площадки могут меняться, и приведённые примеры не описывают другие биржи.

Выбирайте эндпоинт под конкретную задачу

Hyperliquid документирует метод fundingHistory для получения исторических ставок по монете и userFunding для записей фандинга, привязанных к публичному адресу счёта. Первый метод помогает изучать рыночные условия контракта; второй позволяет сверять зафиксированные денежные потоки по счёту. Ряд значений ставки сам по себе не определяет, сколько именно заплатил или получил конкретный аккаунт.

Оба запроса отправляются через JSON POST на адрес https://api.hyperliquid.xyz/info. Для получения ставок BTC за один день UTC тело запроса можно записать следующим образом:

{
  "type": "fundingHistory",
  "coin": "BTC",
  "startTime": 1790208000000,
  "endTime": 1790294399999
}

Эти миллисекундные метки времени ограничивают сутки 24 сентября 2026 года UTC; документированные начало и конец диапазона включительны, поэтому финальное значение представляет собой последнюю миллисекунду этого дня UTC. Идентификатор монеты должен соответствовать опрашиваемому рынку. Актуальная страница API также содержит монеты с префиксом пространства имён декса бессрочных контрактов для некоторых рынков. В документации по фандингу Hyperliquid указано, что бессрочные контракты стандарта HIP-3 используют другую формулу премии, поэтому обязательно сверяйте рыночное наименование конкретного контракта и правила фандинга вместо предположения, что ко всем инструментам применимы базовые настройки.

27 сентября 2026 года для данного окна по BTC было возвращено 24 строки. Первая строка имела метку времени 1790208000045, а последняя — 1790290800038, обе внутри запрошенного дня UTC с интервалом примерно в один час. Фрагмент ответа содержал coin: BTC, fundingRate: 0.0000125, поле премии и миллисекундное значение time. Это воспроизводимое наблюдение API для одного рынка и одной даты, а не доказательство будущего фандинга, результат стратегии или универсальный размер ответа.

наблюдаемая пагинация истории фандинга Hyperliquid с одной пересекающейся граничной строкойНаблюдение fundingHistory по BTC (только чтение), проверено 27 сентября 2026: первая страница из 500 строк заканчивается на 21 сентября 19:00:00.031 UTC; продолжение с этой метки времени возвращает 125 строк, включая граничную строку; сохраните 625 исходных строк и используйте 624 уникальных наблюдения „монета — время“ после проверки пересечения.ПОЛНАЯ СТРАНИЦА — СИГНАЛ К ПРОДОЛЖЕНИЮСТРАНИЦА 1 · 500 СТРОК01 сен → 21 сен · 19:00:00.031 UTCСТРАНИЦА 2 · 125 СТРОКstartTime = метка времени последней строки страницы 126 сен · 23:00 UTCта же пограничная строкасохранить как есть · дедупликация в представлении625 исходных строк − 1 подтверждённый дубликат на границе = 624 уникальных наблюдения «монета — время» · снимок на дату, а не постоянная гарантия
Наблюдение fundingHistory по BTC (только чтение), проверено 27 сентября 2026: первая страница из 500 строк заканчивается на 21 сентября 19:00:00.031 UTC; продолжение с этой метки времени возвращает 125 строк, включая граничную строку; сохраните 625 исходных строк и используйте 624 уникальных наблюдения „монета — время“ после проверки пересечения. ?????????????????? ?????????????????????? ?? ???? ???????????????? ?????????????? ?????????????????? ??????????????

Пагинация длинной истории без потери границ

Общая документация по информационным эндпоинтам Hyperliquid указывает, что ответ на запрос диапазона времени ограничен 500 элементами или отдельными блоками. Для более длинного диапазона клиентам предписывается использовать последнюю возвращённую метку времени в качестве startTime следующего запроса. Это задокументированное правило продолжения выборки для данного API; сохраняйте точный запрос и ответ для каждой страницы, так как пограничная запись может попасть в ответ дважды.

Запрос на чтение по BTC с 1 по 26 сентября 2026 года вернул 500 строк в первом ответе. Его последняя строка находилась на отметке 2026-09-21T19:00:00.031Z. Продолжение выборки с миллисекундной меткой времени этой строки вернуло ещё 125 строк, начиная с той же самой отметки. Суммарно эти ответы содержали 625 необработанных строк, включавших одну повторяющуюся пограничную точку (coin, time) и 624 уникальных наблюдения; финальная уникальная строка была на отметке 2026-09-26T23:00:00.010Z. Наблюдаемые интервалы времени в этой выборке были приблизительно часовыми. Этот пример представляет собой снимок API, проверенный 27 сентября, а не гарантию относительно будущей истории или других рынков.

Сначала сохраняйте исходные байты ответа, затем проверяйте порядок страниц, запрошенную монету, временные границы, количество строк и фактическое перекрытие. Если один и тот же рынок и точная метка времени появляются на соседних страницах, сохраняйте обе исходные копии в архиве и проводите дедупликацию подтверждённой границы уже на уровне аналитического представления. Включайте идентификатор рынка в ключ: одинаковые метки времени разных контрактов не являются дубликатами. Если перекрытие отсутствует, между страницами образовался неожиданный разрыв или повторяющийся ключ встретился внутри одной страницы, остановитесь и проведите расследование вместо тихого удаления или заполнения строк. Сохраняйте метку времени выгрузки и каждое тело запроса рядом с результатами, чтобы последующее обновление не перезаписало доказательства.

В документации описан максимальный размер ответа для запросов временного диапазона, но не каждый возможный сценарий сбоя или постоянная гарантия уровня сервиса. Используйте консервативную частоту запросов и следуйте актуальным ограничениям частоты (rate limits) при выгрузке большого числа страниц. Достижение лимита ответа должно служить сигналом к пагинации; это не означает, что в оставшемся интервале времени отсутствуют записи.

четыре проверки перед тем, как принять постраничную историю финансированияСохраняйте каждую исходную страницу, продолжайте с последней полученной метки времени в миллисекундах, проверяйте точное совпадение рынка и пересечение на границе, а затем удаляйте дубликаты только подтверждённых повторов метки времени по одному и тому же рынку в аналитической копии.СНАЧАЛА СОХРАНИТЬ. ОЧИЩАТЬ ТОЛЬКО ПОСЛЕ ПРОВЕРКИ.01 · Архивзапрос + исходная страница02 · Продолжитьпоследняя метка времени03 · Сравнитьрынок + пересечение04 · Проанализироватьдедупликация по подтверждённому ключуНесовпадение или пропуск?стоп · проверить исходные страницыПовтор метки времени — это дубликат только для того же рынка и подтверждённой границы страницы
Сохраняйте каждую исходную страницу, продолжайте с последней полученной метки времени в миллисекундах, проверяйте точное совпадение рынка и пересечение на границе, а затем удаляйте дубликаты только подтверждённых повторов метки времени по одному и тому же рынку в аналитической копии. ?????????????????? ?????????????????????? ?? ???? ???????????????? ?????????????? ?????????????????? ??????????????
проверка ограниченного ответа по истории фандинга перед исследованиемПроцедура аудита источника фиксирует точный рыночный запрос и время его получения, сохраняет необработанный ответ, а затем проверяет границы UTC, периодичность, дубликаты и пропуски, прежде чем помечать ряд как пригодный для исследования. Отсутствующие наблюдения остаются неизвестными, и один лишь успешный ответ API не подтверждает полное покрытие.ОТ ДОКУМЕНТИРОВАННОГО ЗАПРОСА К ПРОВЕРЯЕМОМУ РЯДУ1 · ЗАПРОСcoin · границы UTCмиллисекунды2 · СОХРАНЕНИЕтело · время получениянеобработанный ответ3 · НОРМАЛИЗАЦИЯUTC · десятичная ставкаидентификатор рынка4 · ПРОВЕРКАпериодичность · дубликатыграницы · пропуски5 · МАРКИРОВКАизвестное / неизвестноевывод о границахНаблюдаемые строки — доказательства только для запрошенного интервалаУспешный ответ HTTP не доказывает полноту · никогда не заполняйте пропущенный час нулёмПеред каждым новым исследованием перепроверяйте схему API площадки и правила финансирования
Процедура аудита источника фиксирует точный рыночный запрос и время его получения, сохраняет необработанный ответ, а затем проверяет границы UTC, периодичность, дубликаты и пропуски, прежде чем помечать ряд как пригодный для исследования. Отсутствующие наблюдения остаются неизвестными, и один лишь успешный ответ API не подтверждает полное покрытие. ?????????????????? ?????????????????????? ?? ???? ???????????????? ?????????????? ?????????????????? ??????????????

Сохраняйте единицы измерения, регулярность и знак

API возвращает числовые значения в виде строк в своих примерах. Парсите их как десятичные числа без ошибочного превращения ставки вида 0.0000125 в 0.0000125%: при умножении на 100 она составляет 0.00125% за представленный интервал. Страница фандинга Hyperliquid описывает почасовые начисления, направление положительной ставки и специфический для биржи метод расчёта. Перепроверяйте документацию перед публикацией численных примеров; не экстраполируйте часовое наблюдение на годовой масштаб, выдавая его за прогноз.

Исключительно для масштаба: номинальная стоимость в $10,000, умноженная на предполагаемую начисленную ставку 0.0000125, даёт величину платежа в $0.125 за этот интервал при упрощённом линейном расчёте. Какая именно сторона платит, зависит от знака ставки и направления позиции. Документированный расчёт площадки использует размер позиции и цену спотового оракула; фактические записи счёта и спецификации инструмента имеют решающее значение для сверки. Эта арифметика не учитывает изменения цен, комиссии и любые другие события по счёту.

Проверяйте ряды данных перед использованием

Архивируйте точное тело запроса, идентификатор рынка, время выгрузки и неизменённый ответ. Переводите каждую миллисекундную метку времени в UTC и сортируйте по времени. Проверяйте наблюдаемую периодичность, ожидаемое число строк для запрошенного диапазона, дубликаты, пропущенные интервалы, непредвиденные названия монет, значения null и элементы, вызвавшие ошибку парсинга чисел. Сравнивайте первое и последнее возвращённое время с границами запроса. Для длинных диапазонов следуйте задокументированному выше правилу продолжения, сопоставляйте границы каждой страницы и фиксируйте строки, исключённые из дедуплицированной аналитической таблицы.

Пропущенные наблюдения остаются неизвестными. Не заполняйте пустой час нулём, не переносите ставку вперёд и не подставляйте ближайшую запись без явного описания этого решения. Для тестов на барах определите, относится ли ставка, зафиксированная на момент расчёта фандинга, к периоду до или после этой метки времени, и согласуйте её с событием начисления на бирже и снимком позиции. Сохраняйте исходные метки времени в UTC, даже если график позже отображает локальное время.

рыночные ставки финансирования и проводки финансирования по счёту — это разные записиЭндпоинт fundingHistory даёт ряд рыночной ставки для указанной монеты и ограниченного интервала времени. Эндпоинт userFunding даёт события журнала финансирования для указанного публичного счёта за интервал времени. Ставка может лечь в основу исследования рынка; событие по счёту необходимо, чтобы сверить фактически проведённый денежный поток этого счёта. Не подменяйте один источник другим.ОДНА ПЛОЩАДКА · РАЗНЫЙ НАБОР ДАННЫХ · РАЗНЫЙ ВОПРОСРЫНОЧНАЯ СТАВКА · fundingHistoryмонета · fundingRate · премия · времяВопрос: какую историю ставки вернули?Подходит для исследования рыночных условий в заданных границахНе доказывает платёж по конкретному счётуЖУРНАЛ СЧЁТА · userFundinguser · coin · szi · usdc · timeВопрос: какое событие записали?Подходит для аудита денежного потока этого счётаАдрес может раскрыть активность по счётуНе подменятьСопоставляйте только при явных допущениях о времени, позиции, контракте и площадкеОтвет по рыночной ставке ≠ доказательство денежного потока по счёту
Эндпоинт fundingHistory даёт ряд рыночной ставки для указанной монеты и ограниченного интервала времени. Эндпоинт userFunding даёт события журнала финансирования для указанного публичного счёта за интервал времени. Ставка может лечь в основу исследования рынка; событие по счёту необходимо, чтобы сверить фактически проведённый денежный поток этого счёта. Не подменяйте один источник другим. ?????????????????? ?????????????????????? ?? ???? ???????????????? ?????????????? ?????????????????? ??????????????

Сверяйте выплаты по счёту отдельно

Задокументированный запрос userFunding принимает адрес счёта и включительное время начала в миллисекундах; время окончания необязательно и по умолчанию равно текущему времени. Пример ответа содержит дельту фандинга с такими полями, как coin, fundingRate, размер позиции, сумма в USDC со знаком и время события. Сравнивайте эти записи событий с позицией счёта и журналом площадки, прежде чем считать какую-либо сумму реализованной. Не привязывайте открытую рыночную ставку к выплате по счёту только по дате и не предполагайте, что каждый счёт имел позицию на момент каждого начисления.

Адрес счёта может раскрывать информацию об активности, даже если этот запрос истории не требует секретного ключа. Избегайте публикации чужого адреса или истории счёта без явной причины и согласия владельца. Никогда не указывайте приватные ключи, seed-фразы или учётные данные для подписи в запросах на чтение информации.

SuperQuant принимает предоставленные пользователем данные по фандингу и включает синтетические примеры; платформа не претендует на ведение полного, независимо верифицированного архива истории Hyperliquid. Используйте разбор ставки финансирования, проверку исторических данных, рабочий лист комиссий и фандинга и аудиторский лист начислений бессрочного фандинга, чтобы хранить правила площадки по каждому событию, исходные ставки и отчёты о выплатах по счёту вместе. Рабочий лист служит вспомогательным инструментом ведения записей, а не коннектором к Hyperliquid или доказательством начисления платежа. Это пошаговое руководство по работе с источником данных, а не инвестиционная рекомендация или одобрение площадки.