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 фандинга: свои пути, поля и способ сообщить интервал.
| Биржа | Текущая ставка | История | Интервал |
|---|---|---|---|
| Binance | GET /fapi/v1/premiumIndex | GET /fapi/v1/fundingRate | GET /fapi/v1/fundingInfo |
| Bybit | GET /v5/market/tickers | GET /v5/market/funding/history | поле fundingIntervalHour |
| OKX | GET /api/v5/public/funding-rate | GET /api/v5/public/funding-rate-history | по fundingTime и nextFundingTime |
| Hyperliquid | POST /info, metaAndAssetCtxs | POST /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).
Чтобы свести эти биржи в одну таблицу, код должен:
- перевести ставки из долей единицы в проценты;
- узнать интервал каждого контракта и привести ставку к 8 часам;
- перевести время из миллисекунд и сопоставить тикеры:
BTCUSDT,BTC-USDT-SWAP,BTC, а у мелких монет — множители вроде1000PEPE; - соблюдать лимиты каждой биржи и править код, когда она меняет API.
Ставки всех бирж одним запросом: /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 (раздел документации). Подробно — в статье «Ставка фандинга как индикатор рынка».
Риски арбитража фандинга
Связка шорт/лонг на двух биржах почти не зависит от цены, но потерять в ней можно:
- ставка меняется до начисления и может сменить знак, а выплату получает только позиция, открытая в момент начисления;
- цены ног расходятся: если на бирже шорта цена ниже, чем на бирже лонга, вход сразу в минусе — сверяйте
priceилиprice_div; - комиссии и проскальзывание: сделок четыре, а на тонком стакане вход дороже, чем в таблице;
- ликвидация одной ноги: маржа между биржами не переносится, а ликвидацию считают по маркировочной цене;
- биржа может сменить интервал или предел ставки контракта, у Binance такие контракты перечисляет
fundingInfo.
Без кода те же ставки показывает таблица «Арбитраж фандинга» (инструкция), связку с комиссиями посчитает калькулятор спредов, а обзор 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. На сайте ставки и спреды фандинга видны без тарифа в разделе «Арбитраж фандинга».