Genesis Arbitrage

Genesis Arbitrage · · 13 мин чтения

API ставок фандинга: ставки всех бирж одним запросом и история начислений

Коротко

  • API фандинга должен отдавать по каждой бирже ставку за интервал, сам интервал, время следующего начисления, ставку в 8-часовом эквиваленте и цену фьючерса.
  • У Binance, Bybit, OKX и Hyperliquid свои эндпоинты, единицы и способы узнать интервал. /funding/rates в Genesis API отдаёт ставки всех бирж одним GET-запросом, в процентах и с приведением к 8 часам.
  • История начисленного фандинга по 13 биржам — суммы, средние ставки, APR, дневные суммы за год и скринер связок с net после комиссий — в /funding/analytics/* на тарифах Pro и Max.

API ставок фандинга — интерфейс, который отдаёт ставки финансирования бессрочных фьючерсов по биржам: ставку за интервал, сам интервал и время следующего начисления, а в полной версии — историю начисленного фандинга. У каждой биржи такой API свой, со своими путями, единицами и интервалами, поэтому для сравнения ставки сводят в одну таблицу, переводят в проценты и приводят к одному периоду, обычно к 8 часам.

Что должен отдавать API фандинга

Ставка без интервала ничего не говорит: 0,02 % раз в 4 часа и 0,02 % раз в 8 часов отличаются вдвое. Поэтому полезный API ставок финансирования отдаёт по каждой паре монета–биржа пять значений.

Что нужноЗачемПоле /funding/rates
Ставка за интервалСколько начислят в ближайшую выплатуfunding_pct
Интервал начисленияБез него ставки бирж не сравнитьinterval
Время следующего начисленияК этому моменту позиция должна быть открытаnext_payout
Ставка за 8 часовСравнение бирж с разными интерваламиfunding_8h_pct
Цена фьючерсаРазница цен ног меняет результат входаprice

Платёж — размер позиции, умноженный на ставку: позиция $10 000 при ставке 0,01 % получает или платит $1 за начисление.

Почему интервалы у бирж разные и как привести ставку к 8 часам

Биржа сама решает, как часто начислять фандинг, и может менять интервал у отдельного контракта. В аналитике Genesis API у CEX встречаются интервалы 8 и 4 часа, у Hyperliquid и Lighter — 1 час. Hyperliquid считает ставку как 8-часовую и начисляет каждый час по одной восьмой от неё, так описано в правилах фандинга Hyperliquid.

В примере из документации Genesis API биржа MEXC начисляет по TON 0,02 % раз в 4 часа: 0,02 × 8 / 4 = 0,04 % за 8 часов. Условный пример с часовым интервалом: биржа A платит 0,004 % каждый час, биржа B — 0,02 % раз в 8 часов. По сырым числам A платит впятеро меньше, а за 8 часов выходит 0,004 × 8 / 1 = 0,032 % против 0,02 %, в 1,6 раза больше.

Приведение предполагает, что ставка продержится весь период, а часовая может смениться уже к следующему начислению. Фактические начисления показывает только история.

APR считают от 8-часовой ставки: три начисления в сутки, 1 095 в год. Для биржи A это 0,032 × 3 × 365 = 35,04 % годовых, пока ставка держится.

API фандинга на биржах: Binance, Bybit, OKX и Hyperliquid

У каждой крупной биржи свой API фандинга: свои пути, поля и способ сообщить интервал.

БиржаТекущая ставкаИсторияИнтервал
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyполе fundingIntervalHour
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-historyпо fundingTime и nextFundingTime
HyperliquidPOST /info, metaAndAssetCtxsPOST /info, fundingHistoryкаждый час

У Binance ставку и время следующего начисления отдают поля lastFundingRate и nextFundingTime метода premiumIndex (документация Binance), метод истории fundingRate принимает startTime и endTime (история ставок). fundingInfo отдаёт интервал только по контрактам, у которых биржа меняла интервал или предел ставки (описание метода).

Bybit отдаёт fundingRate, nextFundingTime и fundingIntervalHour в одном ответе тикеров с category=linear (тикеры Bybit), а в запросе истории обязателен symbol (история Bybit). Интервал, как предупреждает документация, у каждого контракта свой.

У OKX интервал контракта документация предлагает считать по разнице nextFundingTime и fundingTime (документация OKX).

Hyperliquid принимает все запросы данных на POST https://api.hyperliquid.xyz/info, а что вернуть, задаёт JSON-тело: {"type": "metaAndAssetCtxs"} — текущий funding по активам, {"type": "fundingHistory", "coin": "ETH", "startTime": …} — история ставок (документация Hyperliquid).

Чтобы свести эти биржи в одну таблицу, код должен:

Ставки всех бирж одним запросом: /funding/rates

GET /funding/rates возвращает по каждой монете список бирж с текущей ставкой: Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid и другие биржи Genesis Arbitrage, всего 1000+ монет. Фильтры coin и exchange (несколько бирж — через запятую) необязательны, без них приходит полный набор.

curl --compressed \
  "https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

Это элемент массива data в общем конверте Genesis API: success, data, meta. Ставки в процентах, next_payout — время выплаты в формате HH:MM UTC, пустые значения — null, Hyperliquid в ответах называется Hyper. Все поля и форма «Проверить запрос» — в разделе «Ставки фандинга».

/funding/rates и /funding/spread есть на всех тарифах, начиная с Trial за $20 в месяц: 500 тыс. вызовов, 1 запрос в секунду, свежесть данных 60 с (тарифы Genesis API).

Спред фандинга: /funding/spread

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

GET /funding/spread отдаёт по каждой монете лучшую пару бирж в best: exchange_1 и exchange_2, их ставки за свой интервал (funding_1_pct, funding_2_pct), интервалы, время выплат и ссылки на терминалы. Спред пары — в spread_pct, остальные биржи — в others, фильтры — coin и min_spread (раздел «Спред фандинга»). Интервалы пары часто разные, как 1h и 8h у BTC в примере документации, поэтому вручную ставки пары сравнивают после приведения к 8 часам.

Python: топ-10 спредов фандинга в годовых

Скрипт берёт полный набор /funding/rates и по каждой монете находит биржи с наибольшей и наименьшей funding_8h_pct: разница — спред за 8 часов, годовые — спред × 3 × 365. При 429 и 503 он ждёт Retry-After секунд, но не дольше минуты: при исчерпанной месячной квоте Retry-After тянется до её сброса.

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/rates"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def fetch_rates():
    for _ in range(3):
        r = requests.get(URL, headers=HEADERS, timeout=20)
        if r.status_code not in (429, 503):
            r.raise_for_status()
            return r.json()["data"]
        # 429 или 503: ждём Retry-After, но не дольше минуты
        time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
    raise RuntimeError("API не ответил после трёх попыток")


rows = []
for item in fetch_rates():
    ex = [e for e in item["exchanges"]
          if e["funding_8h_pct"] is not None]
    if len(ex) < 2:
        continue
    short = max(ex, key=lambda e: e["funding_8h_pct"])  # шорт
    long_ = min(ex, key=lambda e: e["funding_8h_pct"])  # лонг
    spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
    rows.append((spread, item["coin"], short, long_))

rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
    apr = spread * 3 * 365  # простые годовые на одну ногу
    print(f"{coin:<10} шорт {short['exchange']:<8} "
          f"лонг {long_['exchange']:<8} {spread:.4f}% за 8 ч  "
          f"{apr:.1f}% годовых, на капитал {apr / 2:.1f}%")

Годовые здесь — на номинал одной ноги. Деньги нужны на обе ноги, поэтому на весь капитал без плеча доходность вдвое ниже, как в поле apr_capital аналитики. Условный пример: шорт на бирже с 0,05 % за 8 часов, лонг на бирже с 0,01 %. Спред 0,05 − 0,01 = 0,04 %, годовые 0,04 × 3 × 365 = 43,8 % на ногу и 21,9 % на капитал.

Комиссии сюда не входят. Условный пример: тейкерская комиссия 0,05 % на каждую из четырёх сделок — открыть и закрыть обе ноги — даёт 4 × 0,05 = 0,2 % от номинала ноги. Спред 0,04 % отбивает её за 0,2 / 0,04 = 5 начислений, то есть за 40 часов, если ставки не изменятся.

Квоту списывает только ответ 200. В мониторе опрашивайте не чаще раза в meta.freshness_sec секунд и передавайте прошлый ETag в If-None-Match: неизменившийся полный набор вернётся ответом 304 без списания. Подробнее — в инструкции «Лимиты» и уроке «Монитор спредов и фандинга на Python».

История начисленного фандинга: /funding/analytics/*

Текущая ставка показывает ближайшее начисление, история — сколько начислили фактически. Её отдают четыре эндпоинта аналитики: 13 бирж, ставки в процентах за период начисления, время в epoch-секундах UTC. Они есть на тарифах Pro ($100 в месяц) и Max ($200), Trial и Start получают 403 plan_restricted.

ЭндпоинтЧто внутриПолный раздел
/funding/analytics/summaryСуммы, средние 8-часовые ставки, APR и покрытие за 7 периодов, от 1 дня до года~600 КБ gzip
/funding/analytics/recentКаждая выплата за последние 7 дней~1 МБ gzip
/funding/analytics/dailyДневные суммы за 365 днейдо ~12 МБ gzip
/funding/analytics/topТоп-50 пар монета×биржа и топ-50 связок шорт/лонг за каждый период—

Полные выгрузки без coin ограничены: summary и recent — раз в 60 секунд, daily — раз в 300 секунд на ключ, раньше срока придёт 429 с Retry-After. Срезы с coin и ответы 304 не ограничены, поэтому историю монеты берут так:

curl --compressed -G \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

В сводке у каждой пары монета×биржа есть интервал interval_h, начало данных data_since, последняя 8-часовая ставка last8h для сравнения «сейчас против нормы» и массив m с 14 метриками за период: sum, avg8h, apr, cov, flips и другие. Пример документации: BTC на Binance за 7 дней — 21 положительное начисление, avg8h 0,006298 %, apr 0,006298 × 3 × 365 ≈ 6,896 %. Разбор m, recent и daily — в инструкции «Эндпоинты фандинга», поля — в разделе «Аналитика фандинга».

Скринер связок top

/funding/analytics/top — готовый скринер без параметров. Ноги связки в нём всегда на разных биржах с покрытием не ниже 0,9, связок с net ≤ 0 в списках нет.

gross — валовый фандинг связки за период, fees — комиссии четырёх сделок по таблице taker_fees, net = gross − fees. apr_net — годовые на номинал одной ноги, apr_capital — вдвое меньше, на капитал обеих ног. win_rate — доля прибыльных дней, max_dd — наибольшая просадка, price_div — текущая разница цен ног, в net она не входит.

В примере документации связка PEPE — шорт на HTX, лонг на Hyperliquid под тикером 1000PEPE — за 7 дней дала gross 1,51504 % при fees 0,19. Отсюда net = 1,51504 − 0,19 = 1,32504 %, apr_net 69,09 % и apr_capital 34,55 %. Готовые списки: by_net_apr — по чистой доходности, by_stable — устойчивые связки, by_live — работающие сейчас.

Ставка фандинга как индикатор рынка

При положительной ставке лонги с плечом доплачивают шортам, при отрицательной — наоборот. Небольшой плюс — норма (у Hyperliquid процентная часть ставки зафиксирована на 0,01 % за 8 часов), сигналом становится заметный уход от привычного уровня.

Высокую ставку читают вместе с открытым интересом: если растут оба, в одну сторону набрано много позиций с плечом, и движение против них запускает каскад ликвидаций. Открытый интерес по биржам отдаёт /market/open-interest (раздел документации). Подробно — в статье «Ставка фандинга как индикатор рынка».

Риски арбитража фандинга

Связка шорт/лонг на двух биржах почти не зависит от цены, но потерять в ней можно:

Без кода те же ставки показывает таблица «Арбитраж фандинга» (инструкция), связку с комиссиями посчитает калькулятор спредов, а обзор API данных крипторынка — в статье «API криптовалют».

Вопросы и ответы

Где взять историю ставок фандинга?

У бирж история в своих форматах: GET /fapi/v1/fundingRate у Binance, GET /v5/market/funding/history у Bybit, тип fundingHistory у Hyperliquid. В Genesis API история 13 бирж приходит в одном формате: /funding/analytics/recent — выплаты за 7 дней, /funding/analytics/daily — дневные суммы за год, /funding/analytics/summary — итоги по периодам, на тарифах Pro и Max.

Почему ставки фандинга на биржах разные?

На каждой бирже свои трейдеры, ликвидность, формула и пределы ставки, поэтому перекос позиций складывается по-своему. Различаются и интервалы: 8 или 4 часа у CEX, каждый час у Hyperliquid. Сравнивают ставки после приведения к одному периоду, в Genesis API это поле funding_8h_pct.

Как часто обновляются ставки фандинга в API?

Текущая ставка на бирже меняется до начисления, начисленная фиксируется и уходит в историю. Свежесть данных Genesis API — 60 с на Trial, 30 с на Start, 10 с на Pro и 5 с на Max; ETag сводки аналитики меняется примерно раз в 15 минут, дневные суммы — раз в час.

Есть ли бесплатный API фандинга?

Бесплатного тарифа у Genesis API нет: ставки и спред фандинга входят в Trial за $20 в месяц, история — в Pro за $100 и Max за $200. На сайте ставки и спреды фандинга видны без тарифа в разделе «Арбитраж фандинга».