Документация Genesis API

Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.

ДокументацияАналитика фандинга

Аналитика фандинга

TrialStartProMax

Историческая аналитика начисленного фандинга по 13 биржам — раздел из четырёх эндпоинтов. Все ставки в процентах за период начисления, время в epoch-секундах UTC. Доступно на планах Pro и Max; остальные получают 403 plan_restricted. Полные секции крупные — используйте параметр coin и заголовок If-None-Match (ETag меняется вместе с generated_at). Полная выгрузка секции без coin ограничена: summary и recent — раз в 60 секунд, daily — раз в 300 секунд на ключ; ответы 304 и запросы с coin не ограничены.

Проверить запрос
GET/v1/funding/analytics/summary

Ключ хранится только в вашем браузере и никуда, кроме API, не отправляется.

Вставьте ключ и отправьте запрос — покажем сокращённый ответ.

Аналитика: сводка

Историческая сводка начисленного фандинга по каждой паре монета×биржа: накопленные суммы, средние 8h-ставки, APR и покрытие за 7 периодов от 1 дня до года. Доступно на планах Pro и Max. Полная секция ~600 КБ gzip — для одной монеты используйте параметр coin; при поллинге передавайте If-None-Match (ETag меняется раз в ~15 минут).

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/summary

Параметры запроса

ПараметрТипОписание
coinstringВернуть срез только по одной монете (рекомендуется: полная секция большая)

Пример ответа

json
{
  "success": true,
  "data": {
    "schema_version": 1,
    "units": "percent",
    "generated_at": 1785546602,
    "metric_order": ["sum","avg8h","apr","n","pos","neg","zero","min","max","cov",
                     "med8h","pos_streak","neg_streak","flips"],
    "periods": ["1d","3d","7d","30d","90d","180d","365d"],
    "coins": {
      "BTC": {
        "canon": "BTC",
        "mult": 1,
        "exchanges": {
          "Binance": {
            "raw_symbol": "BTCUSDT",
            "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]
            }
          }
        }
      }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

Поля ответа

ПолеТипОписание
metric_orderstring[]Порядок метрик в массиве m: sum, avg8h, apr, n, pos, neg, zero, min, max, cov
periodsstring[]Доступные периоды: 1d…365d; период отсутствует в m, если данных нет вовсе
coins.{c}.canon / multstring / numberКаноническое имя монеты для склейки вариантов (1000PEPE→PEPE) и мультипликатор контракта; к ставкам mult не применяется
…exchanges.{ex}.interval_hnumberИнтервал начисления в часах: 8/4 у CEX, 1 у Hyper и Lighter
…exchanges.{ex}.data_sincenumberС какого момента есть данные (epoch-сек); не рисуйте нули до этой даты
…exchanges.{ex}.last8hnumber | nullПоследняя фактическая ставка в 8h-эквиваленте — сравнение «сейчас против нормы»
…exchanges.{ex}.m.{period}(number | null)[14]Массив метрик периода в порядке metric_order (14 полей: sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips); индексы 10–13 равны null для периодов 1d и 3d
m[9] (cov)number 0..1Покрытие периода 0..1; при cov < 0.9 данные за часть периода — помечайте в UI

Аналитика: выплаты 7д

Каждая выплата фандинга за последние 7 дней для графиков 1D/3D/7D. Ставки в процентах за период начисления, время — epoch-секунды UTC. Доступно на Pro и Max; полная секция ~1 МБ gzip — рекомендуем coin.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/recent

Параметры запроса

ПараметрТипОписание
coinstringВернуть срез только по одной монете (рекомендуется: полная секция большая)

Пример ответа

json
{
  "success": true,
  "data": {
    "units": "percent",
    "generated_at": 1785546602,
    "days": 7,
    "coins": {
      "BTC": {
        "Lighter": { "i": 1.0, "s": "1784941200:0.0012;1784944800:0.001;1784948400:0.0002" }
      }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

Поля ответа

ПолеТипОписание
daysnumberГлубина данных секции в днях
coins.{c}.{ex}.inumberИнтервал начисления в часах: 8/4 у CEX, 1 у Hyper и Lighter
coins.{c}.{ex}.sstringСтрока точек ts:rate;ts:rate;… по возрастанию времени; ts — epoch-секунды

Аналитика: дни 1г

Дневные суммы фандинга за 365 дней для графиков 1M/3M/1Y. После накопления полной истории секция крупная (~12 МБ gzip) — используйте coin и If-None-Match; данные обновляются раз в час.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/daily

Параметры запроса

ПараметрТипОписание
coinstringВернуть срез только по одной монете (рекомендуется: полная секция большая)

Пример ответа

json
{
  "success": true,
  "data": {
    "units": "percent",
    "generated_at": 1785546602,
    "days": 365,
    "coins": {
      "BTC": { "OKX": "1784937600:0.0027:1:1;1785024000:0.008:3:0" }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

Поля ответа

ПолеТипОписание
daysnumberГлубина данных секции в днях
coins.{c}.{ex}stringСтрока дней day_ts:sum:pos:neg;… — полночь UTC, сумма за день, число положительных и отрицательных начислений

Аналитика: скринер

Готовый скринер: топ-50 пар монета×биржа по накопленному фандингу и топ-50 связок бирж (short/long) за каждый период. Ноги связки всегда на разных биржах с покрытием ≥0.9. gross — до комиссий, net — после тейкерских комиссий четырёх сделок; разница цен ног не учтена. Доступно на Pro и Max.

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/top

Пример ответа

json
{
  "success": true,
  "data": {
    "schema_version": 1,
    "units": "percent",
    "generated_at": 1785545651,
    "taker_fees": { "Binance": 0.05, "Bybit": 0.055, "HTX": 0.05, "Hyper": 0.045, "Lighter": 0.0 },
    "periods": {
      "7d": {
        "by_net_apr": [
          {
            "coin": "PEPE",
            "short_ex": "HTX",   "short_sym": "PEPE",     "short_iv": 8.0,
            "long_ex":  "Hyper", "long_sym":  "1000PEPE", "long_iv":  1.0,
            "gross": 1.51504, "fees": 0.19, "net": 1.32504,
            "apr_net": 69.09, "apr_capital": 34.55,
            "win_rate": 1.0, "max_dd": 0.0, "worst_streak": 0, "risk_days": 7,
            "trend_1d": 0.0471, "trend_7d": 1.515,
            "live_8h": 0.012, "price_div": 0.11, "cov": 1.0
          }
        ],
        "by_stable": [ { "...": "same shape, win_rate >= 0.7" } ],
        "by_live":   [ { "...": "same shape, live_8h > 0 and trend_1d > 0" } ],
        "by_sum_pos": [
          { "coin": "AAOI", "canon": "AAOI", "ex": "Lighter",
            "sum": 11.5165, "apr": 600.5, "cov": 1.0,
            "med8h": 0.062, "pos_streak": 7, "neg_streak": 0, "flips": 0,
            "iv": 1.0, "last8h": 0.058 }
        ],
        "by_sum_neg": [ { "...": "same shape as by_sum_pos" } ]
      }
    }
  },
  "meta": { "count": 7, "updated_at": 1785545651, "schema_version": 1 }
}

Поля ответа

ПолеТипОписание
taker_feesobjectТаблица тейкерских комиссий, применённая в расчёте fees
periods.{p}.by_net_apr / by_stable / by_livearrayby_net_apr — по чистой доходности; by_stable — win_rate ≥ 0.7 и просадка ≤ половины валового; by_live — live_8h > 0 и trend_1d > 0; by_sum_pos / by_sum_neg — однобиржевые топы
bundle.gross / fees / netnumbernet = gross − fees: чистый результат связки после комиссий четырёх сделок; в списках нет строк с net ≤ 0
bundle.apr_net / apr_capitalnumberapr_net — годовых на номинал одной ноги; apr_capital = apr_net / 2 — годовых на вложенный капитал (деньги нужны на обе ноги)
bundle.win_rate / max_dd / worst_streak / risk_daysnumberwin_rate — доля прибыльных дней (0..1), max_dd — максимальная просадка кумулятива, worst_streak — худшая серия убыточных дней, risk_days — по скольким дням оценён риск (не более 90)
bundle.live_8h / trend_1d / trend_7d / price_divnumber | nulllive_8h — текущая разница ставок в 8h-эквиваленте; trend_1d / trend_7d — валовый спред за сутки и неделю; price_div — текущая разница цен ног (null, если цены недоступны)
bundle.short_sym / long_symstringРеальные тикеры ног на биржах — могут отличаться (PEPE и 1000PEPE)
periods.{p}.by_sum_pos / by_sum_negarrayТоп-50 по накопленному фандингу (только cov ≥ 0.5)