Genesis Arbitrage

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

Эндпоинты фандинга Genesis API: ставки, спред и аналитика истории

Коротко

  • /funding/rates и /funding/spread есть на всех тарифах API: ставка каждой биржи за интервал и за 8 часов, время следующей выплаты и лучшая пара бирж по спреду.
  • Аналитика начисленного фандинга — четыре эндпоинта /funding/analytics/… по 13 биржам с историей до года, на тарифах Pro и Max.
  • Полные выгрузки summary, recent и daily весят до ~12 МБ gzip и доступны не чаще раза в 60–300 секунд: берите срез coin или повторяйте запрос с If-None-Match.

API фандинга в Genesis API — эндпоинты со ставками финансирования бессрочных фьючерсов по всем биржам, лучшей парой бирж по спреду фандинга и историей уже начисленного фандинга. Текущие ставки и спред есть на всех тарифах API, историческая аналитика по 13 биржам — на Pro и Max. На сайте те же данные — в «Арбитраже фандинга», см. инструкцию.

Эндпоинты фандинга и тарифы

ЭндпоинтЧто возвращаетТарифы API
/funding/ratesСтавки всех бирж по каждой монетеTrial, Start, Pro, Max
/funding/spreadЛучшая пара бирж по спреду и остальные биржиTrial, Start, Pro, Max
/funding/analytics/summaryСводка за периоды от 1 дня до годаPro, Max
/funding/analytics/recentКаждая выплата за 7 днейPro, Max
/funding/analytics/dailyДневные суммы за 365 днейPro, Max
/funding/analytics/topСкринер пар и связок биржPro, Max

Параметры и поля — в разделах документации «Ставки фандинга», «Спред фандинга» и «Аналитика фандинга». На Trial и Start эндпоинты аналитики отвечают 403 plan_restricted. Обзор API фандинга — в статье «API ставок фандинга». Примеры ответов ниже — сокращённое содержимое поля data.

Ставки и приведение к 8 часам

/funding/rates возвращает по каждой монете список бирж с текущей ставкой. Фильтры coin и exchange (несколько бирж — через запятую) необязательны.

curl "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"
    }
  ]
}
ПолеЧто значит
funding_pctСтавка за интервал начисления, %
funding_8h_pctСтавка, приведённая к 8 часам, %
intervalИнтервал начисления, например 8h; null — нет данных
next_payoutВремя следующей выплаты, HH:MM UTC; null — нет данных
price, trade_urlЦена и ссылка на торговый терминал биржи

Условный пример: часовая ставка 0,005 % — это 0,005 × 8 / 1 = 0,04 % за 8 часов, как у MEXC, только выплат восемь и ставка может смениться уже к следующему часу.

Годовой пересчёт без сложного процента — 8-часовая ставка × 3 × 365 (APR). Условный пример: 0,01 % каждые 8 часов дают 0,01 × 3 × 365 = 10,95 % годовых, пока ставка не изменится. Что ставка говорит о рынке — в статье «Ставка фандинга как индикатор рынка».

Спред фандинга: лучшая пара бирж

/funding/spread отдаёт по каждой монете лучшую пару бирж по спреду фандинга (best) и остальные биржи (others). Фильтры: coin и min_spread — минимальный спред, %.

{
  "coin": "BTC",
  "spread_pct": 0.01,
  "best": {
    "exchange_1": "Hyper",
    "exchange_2": "CoinEx",
    "funding_1_pct": 0.0,
    "funding_2_pct": 0.0,
    "next_payout_1": null,
    "next_payout_2": "08:00",
    "interval_1": "1h",
    "interval_2": "8h",
    "trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
    "trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
  },
  "others": [ … ]
}

spread_pct — спред лучшей пары, %. funding_1_pct и funding_2_pct — ставки за свой интервал (interval_1, interval_2): чтобы сравнить их вручную, приведите обе к 8 часам. Шорт открывают там, где ставка выше, лонг — где ниже. Hyperliquid в ответах называется Hyper.

Скрипт на Python печатает десять монет с наибольшим spread_pct (от 0,05 %) и интервалы начисления пары. При 429 и 503 он ждёт Retry-After секунд; в цикле повторяйте запрос не чаще раза в meta.freshness_sec.

import os
import time
import requests

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

for _ in range(3):
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 0.05}, timeout=15)
    if r.status_code not in (429, 503):
        break
    # лимит запросов или пересборка данных — ждём
    time.sleep(int(r.headers.get("Retry-After", "5")))
r.raise_for_status()

rows = sorted(r.json()["data"], key=lambda x: x["spread_pct"],
              reverse=True)
for row in rows[:10]:
    b = row["best"]
    print(f'{row["coin"]:<10} {row["spread_pct"]:>8.4f}%  '
          f'{b["exchange_1"]} {b["interval_1"]} / '
          f'{b["exchange_2"]} {b["interval_2"]}')

Аналитика начисленного фандинга

Четыре эндпоинта /funding/analytics/… отдают историю уже начисленного фандинга по 13 биржам — те же данные, что показывает вкладка «Аналитика» в «Арбитраже фандинга». Ставки — в процентах за период начисления, время — в epoch-секундах UTC.

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

Полная выгрузка раньше срока получит 429 с Retry-After. Правила ETag и сжатия — в инструкции «Формат ответа и ошибки».

curl --compressed -i \
  "https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -H "If-None-Match: <ETag из прошлого ответа>"

--compressed просит сжатый ответ и сам его распаковывает, -i выводит заголовки — среди них ETag. Первый запрос отправьте без If-None-Match.

Сводка и массив m

У каждой пары монета×биржа в сводке есть m: ключ — период (1d, 3d, 7d, 30d, 90d, 180d, 365d), значение — 14 чисел в порядке metric_order. Периода нет в m, если данных за него нет вовсе.

{
  "metric_order": ["sum", "avg8h", "apr", "n", "pos", "neg", "zero",
                   "min", "max", "cov", "med8h", "pos_streak",
                   "neg_streak", "flips"],
  "coins": {
    "BTC": {
      "canon": "BTC",
      "mult": 1,
      "exchanges": {
        "Binance": {
          "interval_h": 8.0,
          "data_since": 1568102400,
          "last8h": 0.004123,
          "m": {
            "7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0,
                   0.000125, 0.01, 1.0, 0.00588, 7, 0, 0]
          }
        }
      }
    }
  }
}
МетрикаИндексЧто значит
sum0Накоплено за период, %
avg8h1Средняя ставка в 8-часовом выражении, %
apr2Годовых, %
n3Число начислений
pos, neg, zero4–6Начисления с плюсом, с минусом и нулевые
min, max7–8Минимальное и максимальное начисление, %
cov9Покрытие периода от 0 до 1
med8h10Медиана в 8-часовом выражении, %
pos_streak, neg_streak11–12Дней подряд в плюсе и в минусе
flips13Смен знака

Индексы 10–13 у периодов 1d и 3d — null. При cov < 0,9 данные покрывают только часть периода — помечайте такие значения. В примере BTC на Binance за 7 дней: 21 начисление, все положительные, cov 1,0, а apr равен avg8h × 3 × 365: 0,006298 × 1095 ≈ 6,896.

Если avg8h заметно выше med8h, среднюю завысил всплеск: устойчивость лучше видна по медиане, pos_streak и flips. Остальные поля пары:

Выплаты за 7 дней и дневные суммы

В /funding/analytics/recent у каждой биржи есть строка s вида ts:rate;ts:rate;… по возрастанию времени и интервал i в часах. В /funding/analytics/daily строка day_ts:sum:pos:neg;… хранит полночь UTC, сумму за день и число положительных и отрицательных начислений.

def parse_recent(s):
    # "ts:rate;ts:rate;…" → [(время, ставка), …]
    return [(int(t), float(v)) for t, v in
            (p.split(":") for p in s.split(";") if p)]


def parse_daily(s):
    # "day_ts:sum:pos:neg;…" → [(день, сумма, плюс, минус), …]
    out = []
    for p in filter(None, s.split(";")):
        d, total, pos, neg = p.split(":")
        out.append((int(d), float(total), int(pos), int(neg)))
    return out

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

/funding/analytics/top — готовый скринер без параметров: за каждый период топ-50 пар монета×биржа по накопленному фандингу и топ-50 связок шорт/лонг. Ноги связки всегда на разных биржах с покрытием не ниже 0,9, строк с net ≤ 0 в списках нет.

Поле связкиЧто значит
gross, fees, netВаловый фандинг, комиссии четырёх сделок по taker_fees и net = gross − fees
apr_net, apr_capitalГодовых на номинал одной ноги и apr_net / 2 — на капитал обеих ног
win_rate, max_ddДоля прибыльных дней (0..1) и максимальная просадка накопленного результата
worst_streak, risk_daysХудшая серия убыточных дней и дни оценки риска, не больше 90
live_8h, trend_1d, trend_7dТекущая разница ставок за 8 часов и валовый спред за сутки и неделю
price_divТекущая разница цен ног; null, если цен нет
short_sym, long_symРеальные тикеры ног на биржах, они могут различаться: PEPE и 1000PEPE

В примере из документации связка PEPE — шорт на HTX, лонг на Hyperliquid — за 7 дней дала gross 1,51504 %. Комиссии — по 0,05 % за открытие и закрытие на HTX и по 0,045 % на Hyperliquid: 0,05 × 2 + 0,045 × 2 = 0,19.

Отсюда net = 1,51504 − 0,19 = 1,32504 %, apr_net = 1,32504 × 365 / 7 ≈ 69,09 %, apr_capital = 69,09 / 2 ≈ 34,55 %. Разница цен ног, проскальзывание и маржа в расчёт не входят.

Как собрать монитор фандинга

  1. Найдите кандидатов

    Запросите /funding/spread с min_spread (любой тариф API) и отсортируйте по spread_pct.

  2. Проверьте ставки и выплаты

    Запросите /funding/rates с coin: interval, next_payout и funding_8h_pct на обеих биржах. Позиция должна быть открыта к моменту начисления.

  3. Посмотрите историю

    На Pro и Max запросите /funding/analytics/summary с coin: sum, apr, cov и flips за 7d и 30d покажут, держится ли разница ставок.

  4. Оцените связку целиком

    В /funding/analytics/top сравните net, apr_capital, win_rate, max_dd и текущую price_div.

  5. Откройте позиции сами

    Ссылки trade_url ведут в терминалы бирж, связку с комиссиями посчитайте в калькуляторе спредов.

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

Как привести ставку фандинга к 8 часам?

Умножьте ставку за интервал на 8 и разделите на длину интервала в часах. /funding/rates делает это сам — поле funding_8h_pct.

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

/funding/analytics/recent — каждая выплата за 7 дней, /funding/analytics/daily — дневные суммы за год, /funding/analytics/summary — итоги по периодам. Все три — на тарифах API Pro и Max.

Почему полный раздел аналитики отвечает 429?

Полная выгрузка без coin ограничена: summary и recent — раз в 60 секунд, daily — раз в 300 секунд на ключ. Срезы coin и ответы 304 на If-None-Match не ограничены.