Genesis Arbitrage

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

API открытого интереса: OI по фьючерсам бирж и как его читать

Коротко

  • Открытый интерес — объём фьючерсных позиций, которые ещё не закрыты. В монетах он показывает приток позиций, в долларах меняется ещё и вместе с ценой.
  • Биржи отдают OI каждая в своём формате и своих единицах. В Genesis API один вызов /market/open-interest даёт 13+ бирж — сумму в total, разбивку в exchanges и изменения OI и цены за 5, 15, 30 минут и час — на всех тарифах.
  • OI вместе с ценой и фандингом показывает, кто набирает позиции и кто за них платит. Направление цены он не предсказывает; решение и сделка на бирже остаются за вами.

API открытого интереса отдаёт по каждой монете объём открытых фьючерсных позиций — в монетах и в долларах, на каждой бирже и в сумме — и то, как он менялся за последние минуты и часы. Биржи публикуют OI своих контрактов в собственных API, и форматы у всех разные. В Genesis API весь срез приходит одним вызовом /market/open-interest: 13+ фьючерсных бирж, среди них Binance, Bybit, OKX, Bitget и Gate, изменения OI и цены за 5, 15, 30 минут и час, на всех тарифах — от Trial за $20 в месяц.

Что такое открытый интерес

Открытый интерес (open interest, OI) — сумма позиций по фьючерсному контракту, которые открыты и ещё не закрыты. У каждого контракта две стороны, лонг и шорт, и OI считают по одной: один трейдер купил 1 BTC в лонг, другой продал 1 BTC в шорт — открытый интерес вырос на 1 BTC.

OI растёт, когда обе стороны сделки открывают позиции, падает, когда обе закрывают, и не меняется, когда позиция переходит от одного трейдера к другому. Поэтому рост OI означает приток новых позиций, а падение — их закрытие, добровольное или принудительное.

OI в монетах и в долларах

Биржи отдают OI в контрактах, в монетах или сразу в долларах, а из монет в доллары его переводят по цене. В примере ответа Genesis API у ByBit по монете GRAM oi_usd равен oi_tokens, умноженному на price: 16 159 003,8 × 1,6609 = 26 838 489,41.

Долларовая оценка удобна для сравнения монет и бирж, но движется вместе с ценой. Условный пример: на бирже открыто 2 000 000 монет по $1,50, и OI равен 2 000 000 × $1,50 = $3 000 000. Через час позиций столько же, цена $1,65, и OI в долларах уже 2 000 000 × $1,65 = $3 300 000 — плюс 10 %, хотя новых позиций нет.

Суммарный OI и разбивка по биржам

Суммарный OI монеты складывается из OI бирж, где у неё есть фьючерс, и показывает, сколько денег рынок держит в позициях. Разбивка показывает, где именно: в том же ответе на ByBit приходится 26 838 489,41 / 96 544 685,3 × 100 = 27,8 % долларового OI монеты GRAM.

МераЧто показываетГде ловушка
OI в монетахСколько позиций открытоВ контрактах у каждой биржи свой размер
OI в долларахСколько денег в позицияхМеняется вместе с ценой
Суммарный OIПозиции рынка в целомЗависит от набора бирж в сумме
OI по биржеГде набирают позицииМетодики бирж различаются

Что отдают API Binance, Bybit, OKX и Hyperliquid

Каждая биржа публикует OI своих контрактов в своём API. По официальной документации картина такая:

БиржаТекущий OIИстория OIЧто учесть
BinanceGET /fapi/v1/openInterest, один symbol за запросGET /futures/data/openInterestHistИстория — только за последний месяц
BybitGET /v5/market/tickers, все символы одним запросомGET /v5/market/open-interest, шаг от 5min до 1dopenInterest — обе стороны, singleOpenInterest — одна
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi — контракты, oiCcy — монеты, oiUsd — доллары
HyperliquidPOST /info, тип metaAndAssetCtxsНет в документацииOI бессрочных фьючерсов одним запросом

Подробности — в документации Binance, Bybit, OKX и Hyperliquid. История Binance приходит полями sumOpenInterest и sumOpenInterestValue, у OKX — последние 1 440 записей с шагом от 5 минут. Hyperliquid принимает запрос на https://api.hyperliquid.xyz/info с телом {"type": "metaAndAssetCtxs"} и возвращает openInterest каждого перпетуала рядом с markPx и funding.

Разница в методике бывает двукратной. В примере ответа Bybit /v5/market/open-interest поле openInterest равно 63 910 691, а singleOpenInterest — 31 955 346, ровно вдвое меньше: первое считает обе стороны, второе — одну, как в определении OI выше.

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

Открытый интерес в Genesis API: /market/open-interest

Эндпоинт /market/open-interest отдаёт то же, что таблица Трекинг OI на сайте: по каждой монете суммарный OI в total и разбивку по биржам в exchanges. Без параметров приходят все монеты; coin оставит одну монету, exchange — выбранные биржи, несколько через запятую.

curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Ответ — массив data. Ниже его элемент из документации, часть полей сокращена:

{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_5m": 0.0196,
    "oi_change_1h": 0.3185,
    "price_change_5m": -0.0228,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_tokens": 16159003.8,
      "oi_change_1h": -0.097,
      "price_change_1h": -0.1683,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}
ПолеЧто значит
total.oi_usd / total.oi_tokensСуммарный OI в долларах и в монетах
total.avg_priceСредняя цена монеты по биржам
total.volume_24hОбъём за 24 часа, USD
total.oi_change_5m/15m/30m/1hИзменение OI за 5, 15, 30 минут и час, %
total.price_change_5m/15m/30m/1hИзменение цены за те же интервалы, %
exchanges{}Те же метрики по каждой бирже: price вместо avg_price, плюс trade_url

Изменения — в процентах: 0.3185 значит 0,3185 %. Пустые значения приходят как null, их пропускают. Свежесть задаёт тариф: 60 с на Trial, 30 с на Start, 10 с на Pro и 5 с на Max, поэтому опрашивать чаще meta.freshness_sec бессмысленно.

Ответ без фильтров приходит с заголовком ETag. Если вернуть его в If-None-Match, неизменившийся срез придёт ответом 304, а такой ответ квоту не тратит — подробнее в термине ETag и If-None-Match. Фильтр exchange сужает только exchanges: total по-прежнему посчитан по всем биржам.

Поля, параметры и форма «Проверить запрос» — в разделе документации «OI Трекинг». Разбор всех рыночных эндпоинтов с примерами — в инструкции «Рынок в Genesis API».

Как читать OI вместе с ценой: четыре сценария

Рост OI говорит, что позиции открываются, но не говорит, какая сторона ведёт. Это подсказывает цена за тот же интервал.

ЦенаOIКак это обычно читаютЧто проверить
РастётРастётНовые позиции по ходу движения, рост поддержан деньгамиФандинг: сильный плюс — лонги перегреты
ПадаетРастётНабираются шорты или лонги против паденияФандинг: сильный минус — риск шорт-сквиза
РастётПадаетРост идёт на закрытии шортов, новых денег нетПадает ли OI на всех биржах
ПадаетПадаетЗакрываются лонги, сами или принудительноОбвал OI за 5 минут — признак ликвидаций

В примере из документации суммарный OI монеты GRAM за час вырос на 0,32 %, а цена снизилась на 0,19 % — формально вторая строка. Но доли процента за час — обычные колебания: сценарии из таблицы читают на заметных движениях и на монетах с крупным OI.

OI и фандинг: кто держит позиции и кто за них платит

Ставка фандинга показывает, какая сторона бессрочных фьючерсов доплачивает другой, а OI — сколько позиций открыто. Вместе они показывают и наклон рынка, и то, насколько он нагружен плечом.

Рост OI и цены при сильно положительной ставке значит, что лонги набирают позиции и платят за них шортам. Если цена развернётся, их ликвидации ускорят падение. Рост OI и цены при отрицательной ставке — шорты набирают против движения, и резкий рост цены может закрыть их принудительно.

Все сочетания фандинга, OI и цены собраны в статье «Ставка фандинга как индикатор рынка». В Genesis API ставки всех бирж отдаёт /funding/rates, тоже на всех тарифах: ставку за интервал начисления (funding_pct) и приведённую к 8 часам (funding_8h_pct). Эндпоинты фандинга и история начислений разобраны в статье «API ставок фандинга», поля — в документации.

Python: OI за час вырос больше чем на 5 % при росте цены

Скрипт берёт весь срез одним вызовом и оставляет монеты, где суммарный OI за час вырос больше чем на 5 %, цена выросла, а сам OI не меньше $5 млн. По каждой он печатает разбивку по биржам: долю биржи в OI и её изменения OI и цены за час. Ключ — в переменной окружения GENESIS_API_KEY; на 429 и 503 скрипт ждёт Retry-After секунд и повторяет запрос.

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000  # на малом OI одна позиция даёт большой %

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # лимит или пересборка
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

def passes(t):
    oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or px is None:
        return False
    return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0

def pct(v):
    return "н/д" if v is None else f"{v:+.1f}%"

hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
    t = row["total"]
    print(f"{row['coin']}: OI {pct(t['oi_change_1h'])} за час, "
          f"цена {pct(t['price_change_1h'])}, "
          f"всего ${t['oi_usd'] / 1e6:.1f} млн")
    exs = sorted(row["exchanges"].items(), reverse=True,
                 key=lambda kv: kv[1].get("oi_usd") or 0)
    for name, m in exs:
        share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
        print(f"  {name:<8} доля {share:4.1f}%, "
              f"OI {pct(m.get('oi_change_1h'))}, "
              f"цена {pct(m.get('price_change_1h'))}")

Условный пример вывода — монета XYZ: OI за час +6,2 %, цена +3,0 %, суммарный OI $48,1 млн.

БиржаДоля OIOI за часЦена за час
Binance46,2 %+8,0 %+3,0 %
ByBit27,0 %+5,0 %+3,1 %
OKX17,5 %+2,0 %+2,9 %
Bitget9,3 %+9,0 %+3,2 %

Рост широкий: OI прибавил на всех четырёх биржах, на трёх — на 5 % и больше. Если бы те же +6,2 % дала одна биржа, у которой час назад было 10 % OI монеты, её OI вырос бы на 62 %: 0,10 × 62 = 6,2. Всплеск на одной площадке чаще означает одного крупного участника, и выводы о рынке по нему делать рано.

Вторая часть добавляет фандинг: один вызов /funding/rates на все монеты, а по каждой найденной — минимальная и максимальная ставка за 8 часов и число бирж с плюсом.

# ставки всех бирж — один вызов на все монеты
rates = {row["coin"]: row["exchanges"]
         for row in get("/funding/rates")}

for row in hits:
    fr = sorted((e["funding_8h_pct"], e["exchange"])
                for e in rates.get(row["coin"], [])
                if e.get("funding_8h_pct") is not None)
    if not fr:
        print(f"{row['coin']}: ставок фандинга нет")
        continue
    (lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
    plus = sum(1 for rate, _ in fr if rate > 0)
    print(f"{row['coin']}: фандинг за 8 ч от {lo:+.4f}% ({lo_ex}) "
          f"до {hi:+.4f}% ({hi_ex}), плюс на {plus} из {len(fr)}")

Скрипт делает два вызова. Если запускать его раз в минуту, это 2 × 60 × 24 × 30 = 86 400 вызовов за 30 дней — меньше пятой части квоты Trial в 500 тыс. Чтобы опрашивать по кругу и не тратить квоту на неизменившиеся данные, добавьте ETag и If-None-Match: приёмы — в статье «Как опрашивать API без лимитов», квоты и запросы в секунду — в инструкции «Лимиты Genesis API».

Оговорки: что искажает открытый интерес

Без кода те же данные — в таблице Трекинг OI на сайте; колонки, фильтры и графики описаны в инструкции. Квоты и цены тарифов API — на странице «Тарифы Genesis API».

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

Чем открытый интерес отличается от объёма торгов?

Объём — сумма сделок за период, открытый интерес — позиции, которые остаются открытыми сейчас. Сделка входит в объём всегда, а OI меняет, только если обе стороны открывают или обе закрывают позиции. Высокий объём при стоящем OI значит, что позиции в основном переходят из рук в руки. В ответе /market/open-interest есть оба числа: volume_24h и oi_usd.

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

В Genesis API истории нет: эндпоинт отдаёт текущий срез и изменения за 5, 15, 30 минут и час, а длинный ряд копят сами, сохраняя ответы. У бирж история есть в их API: Binance отдаёт её за последний месяц, Bybit — с шагом от 5 минут до суток, OKX — последние 1 440 записей. На сайте график OI открывает кнопка «График» в Трекинге OI на тарифе сайта Pro.

Как часто обновляются данные OI в Genesis API?

Свежесть задаёт тариф API: 60 секунд на Trial, 30 на Start, 10 на Pro и 5 на Max. Время сборки среза — в meta.updated_at, задержка для вашего тарифа — в meta.freshness_sec. Опрашивать чаще этой задержки нет смысла, а с If-None-Match неизменившийся срез вернётся ответом 304, который квоту не тратит.

Что значит рост открытого интереса при падении цены?

Обычно открываются новые шорты или кто-то набирает лонги против движения. Если ставка фандинга при этом уходит в минус, шорты ещё и доплачивают лонгам за позицию. Резкий разворот цены вверх в такой момент может закрыть шорты принудительно и ускорить рост.