Эндпоинты фандинга 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]
}
}
}
}
}
}
| Метрика | Индекс | Что значит |
|---|---|---|
sum | 0 | Накоплено за период, % |
avg8h | 1 | Средняя ставка в 8-часовом выражении, % |
apr | 2 | Годовых, % |
n | 3 | Число начислений |
pos, neg, zero | 4–6 | Начисления с плюсом, с минусом и нулевые |
min, max | 7–8 | Минимальное и максимальное начисление, % |
cov | 9 | Покрытие периода от 0 до 1 |
med8h | 10 | Медиана в 8-часовом выражении, % |
pos_streak, neg_streak | 11–12 | Дней подряд в плюсе и в минусе |
flips | 13 | Смен знака |
Индексы 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. Остальные поля пары:
data_since— с какого момента есть данные; до этой даты нули не рисуют.last8h— последняя ставка в 8-часовом выражении, для сравнения «сейчас против нормы».interval_h— интервал начисления: 8 или 4 часа у CEX, 1 час у Hyperliquid и Lighter.canonиmult— имя для склейки тикеров (1000PEPE→PEPE) и множитель контракта; к ставкамmultне применяется.
Выплаты за 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 в списках нет.
by_net_apr— по чистой доходности.by_stable—win_rate≥ 0,7 и просадка не больше половины валового.by_live—live_8h> 0 иtrend_1d> 0.by_sum_pos,by_sum_neg— однобиржевые топы по накопленному фандингу, толькоcov≥ 0,5.
| Поле связки | Что значит |
|---|---|
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 %. Разница цен ног, проскальзывание и маржа в расчёт не входят.
Как собрать монитор фандинга
Найдите кандидатов
Запросите
/funding/spreadсmin_spread(любой тариф API) и отсортируйте поspread_pct.Проверьте ставки и выплаты
Запросите
/funding/ratesсcoin:interval,next_payoutиfunding_8h_pctна обеих биржах. Позиция должна быть открыта к моменту начисления.Посмотрите историю
На Pro и Max запросите
/funding/analytics/summaryсcoin:sum,apr,covиflipsза 7d и 30d покажут, держится ли разница ставок.Оцените связку целиком
В
/funding/analytics/topсравнитеnet,apr_capital,win_rate,max_ddи текущуюprice_div.Откройте позиции сами
Ссылки
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 не ограничены.