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 | Что учесть |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, один symbol за запрос | GET /futures/data/openInterestHist | История — только за последний месяц |
| Bybit | GET /v5/market/tickers, все символы одним запросом | GET /v5/market/open-interest, шаг от 5min до 1d | openInterest — обе стороны, singleOpenInterest — одна |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi — контракты, oiCcy — монеты, oiUsd — доллары |
| Hyperliquid | POST /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 млн.
| Биржа | Доля OI | OI за час | Цена за час |
|---|---|---|---|
| Binance | 46,2 % | +8,0 % | +3,0 % |
| ByBit | 27,0 % | +5,0 % | +3,1 % |
| OKX | 17,5 % | +2,0 % | +2,9 % |
| Bitget | 9,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».
Оговорки: что искажает открытый интерес
- Методики бирж различаются. У Bybit два поля OI с двукратной разницей, у OKX
oiсчитается в контрактах, размер которых задаёт биржа, а тикер одной монеты бывает разным — PEPE на одной бирже и 1000PEPE на другой. Между биржами надёжнее сравнивать изменения в процентах: они не зависят от единиц, пока биржа считает одинаково от замера к замеру. - Доллары зависят от цены.
oi_usdкаждой биржи — её OI в монетах, умноженный на её цену, поэтому на резком движении долларовый OI меняется, даже когда позиции стоят. - Ликвидации дают всплески. При каскаде ликвидаций биржи закрывают позиции принудительно: OI за минуты падает на проценты, цена резко движется. Обвал
oi_change_5mвместе с резкимprice_change_5m— почерк ликвидаций. - Малый OI даёт большой процент. На монете с OI в несколько сотен тысяч долларов одна позиция меняет его на десятки процентов, и порог по
total.oi_usdотсекает этот шум. - Сумма зависит от состава бирж. Если монету запустили на фьючерсах ещё одной биржи, суммарный OI вырастет за счёт новой площадки, хотя на остальных ничего не изменилось. Сверяйте рост суммы с разбивкой
exchanges.
Без кода те же данные — в таблице Трекинг 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, который квоту не тратит.
Что значит рост открытого интереса при падении цены?
Обычно открываются новые шорты или кто-то набирает лонги против движения. Если ставка фандинга при этом уходит в минус, шорты ещё и доплачивают лонгам за позицию. Резкий разворот цены вверх в такой момент может закрыть шорты принудительно и ускорить рост.