LootX

Открытый интерес и фандинг

Обновлено 18 ноября 2026 г. Эта страница в PDF

Минутные бары открытого интереса в долларах, монетах или родной единице биржи; ставка фандинга по минутам и сами начисления; long/short ratio по 5-минутным бакетам; mark и index по секундам и минутам.

Только бессрочные контракты: market = perp. Биржи: binance, bybit, okx, bitget, gate, mexc, bingx, kucoin, hyperliquid, aster, kraken, coinbase. У long/short и mark и index свои наборы бирж — они названы в разделах.

Открытый интерес

GET/v1/oi

Минутные бары открытого интереса: открытие, максимум, минимум и закрытие минуты. Группа тарифа — oi.

Параметр Что
instrument обязательный, только перпы
from начало, мс. По умолчанию — сутки назад от to
to конец, мс, не включительно
unit usd (по умолчанию), coins или native — как у биржи: монеты, контракты или доллары
cursor курсор из next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/oi?instrument=bybit:perp:ETHUSDT&unit=usd&from=1793750400000&to=1793750520000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "bybit:perp:ETHUSDT",
  "tf": "1m",
  "columns": ["ts", "open", "high", "low", "close"],
  "rows": [
    [1793750400000, 1843204551.12, 1843990120.4, 1842871003.57, 1843511876.03],
    [1793750460000, 1843511876.03, 1844102233.9, 1843300418.65, 1843877021.18]
  ],
  "next_cursor": null
}

ts — начало минуты. Страница — до недели минут; длинный период листайте курсором.

Ставка фандинга

GET/v1/funding

Ставка фандинга, как биржа показывала её каждую минуту, со временем следующего начисления там, где биржа его сообщает (у Hyperliquid, MEXC, Kraken и Coinbase next_funding_ts — null). Группа тарифа — funding.

Параметр Что
instrument обязательный
from, to, cursor окно и курсор
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1m",
  "columns": ["ts", "rate", "next_funding_ts", "interval_hours"],
  "rows": [[1793750400000, 0.0001, 1793779200000, 8]],
  "next_cursor": null
}
  • rate — доля за период выплаты биржи: 0.0001 — это 0,01 % за 8 часов;
  • interval_hours — период выплаты, как его сообщает источник.

Начисления фандинга

GET/v1/funding/events

Сами моменты расчёта: какая ставка применилась и по какой цене маркировки. Та же группа funding.

Параметр Что
instrument обязательный, только перпы
from начало, мс. По умолчанию — 30 суток назад от to
to конец, мс, не включительно
cursor курсор из next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/funding/events?instrument=binance:perp:BTCUSDT" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "columns": ["t", "rate", "mark_price"],
  "rows": [
    [1793721600000, 0.00009249, null],
    [1793721600006, 0.00009208, 104012.4],
    [1793750400000, 0.000072, 104250.5]
  ],
  "next_cursor": null
}

mark_price заполняется только у Binance, у остальных бирж она null; у Binance null стоит и в повторной строке начисления (см. выше). Для расчёта своих платежей умножайте ставку на номинал позиции в момент начисления: суммы не округляются к шагу цены ни у нас, ни в ваших расчётах не должны.

Long/Short ratio

GET/v1/ls-ratio

Соотношение лонгов и шортов и объём тейкера по 5-минутным бакетам — как их публикует биржа. Группа тарифа — ls_ratio.

Параметр Что
instrument обязательный, только перпы. Ряды есть у binance (global_account, top_account, top_position, taker_volume), bybit (global_account) и okx (те же четыре и global_account_ccy); у остальных бирж открытого интереса ответ пустой
kind вид ряда: global_account, top_account, top_position, taker_volume, global_account_ccy. По умолчанию — все. Иной — 400 bad_request с param: "kind"
from начало, мс, по ts. По умолчанию — сутки назад от to
to конец, мс, не включительно
cursor курсор из next_cursor

Отношения площадок не складываются: instruments= с двумя и больше инструментами — 400 bad_request, запрашивайте каждую биржу своим instrument.

Shell
curl -s "https://market-api.lootx.trade/v1/ls-ratio?instrument=binance:perp:BTCUSDT&from=1793278200000&to=1793278500000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "5m",
  "columns": ["ts", "as_of", "kind", "long_ratio", "short_ratio", "long_short_ratio", "buy_vol", "sell_vol", "unit"],
  "rows": [
    [1793278200000, 1793278200000, "global_account", 0.6849, 0.3151, 2.1736, null, null, null],
    [1793278200000, 1793278500000, "taker_volume", null, null, 1.1138, "82.8880", "74.4160", "base"],
    [1793278200000, 1793278200000, "top_account", 0.6982, 0.3018, 2.3135, null, null, null],
    [1793278200000, 1793278200000, "top_position", 0.6774, 0.3226, 2.0995, null, null, null]
  ],
  "next_cursor": null
}
Колонка Что
ts бакет биржи (bucket_ts), мс. Строки идут по ts, внутри — по kind
as_of момент, к которому относится значение, мс. У global_account, top_account, top_position Binance и у global_account Bybit — ts: это снимок на отметке. У taker_volume Binance и у всех видов OKX — ts + 5 минут: значение за период [ts, ts + 5 мин). У прочих пар — ts. Ряды разных бирж и видов сводите по as_of
long_ratio, short_ratio доли лонгов и шортов, безразмерные: 0.6849 — 68,49 %
long_short_ratio отношение лонгов к шортам, у taker_volume — покупок тейкера к продажам
buy_vol, sell_vol объём покупок и продаж тейкера за бакет — строкой, точная десятичная запись биржи, в единице unit. Только у taker_volume
unit единица buy_vol и sell_vol: base — монеты. У остальных видов — null

Чего биржа не публикует, то null: у OKX, например, приходит только long_short_ratio, без долей. Последний бакет биржа дописывает и после его конца: перечитывайте последние ~10 минут. Окно длиннее недели шлюз режет и отдаёт next_cursor; страница — до 10 000 строк, и строки одного ts целиком попадают на одну страницу.

GET/v1/ls-ratio/latest

Последняя строка каждого вида — или только вида kind — за 35 суток. Та же группа ls_ratio, те же колонки, next_cursor — null.

Параметр Что
instrument обязательный, только перпы
kind вид ряда, как у /v1/ls-ratio. По умолчанию — все
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "5m",
  "columns": ["ts", "as_of", "kind", "long_ratio", "short_ratio", "long_short_ratio", "buy_vol", "sell_vol", "unit"],
  "rows": [
    [1793279100000, 1793279100000, "global_account", 0.684, 0.316, 2.1646, null, null, null],
    [1793278800000, 1793279100000, "taker_volume", null, null, 2.9092, "786.2880", "270.2730", "base"],
    [1793279100000, 1793279100000, "top_account", 0.6978, 0.3022, 2.3091, null, null, null],
    [1793279100000, 1793279100000, "top_position", 0.6779, 0.3221, 2.1047, null, null, null]
  ],
  "next_cursor": null
}

У каждого вида своя последняя строка, и ts у них может различаться, как у taker_volume в примере. Ни одной строки за 35 суток — 404 not_found; ряд, замолчавший раньше, читайте через /v1/ls-ratio с окном.

Mark и index

GET/v1/mark

Цена маркировки (mark) и индексная цена (index) перпа по секундам или минутам. Группа тарифа зависит от шага: tf=1m — mark, tf=1s — mark_1s.

Параметр Что
instrument обязательный, только перпы: binance, bybit, okx, bitget, gate, hyperliquid, mexc, kraken, lighter, aster. Другая биржа — 400 unsupported_instrument
tf 1s — секунды, хранятся 7 суток; 1m — минуты, без срока. По умолчанию 1m. Другой шаг — 400 bad_request с param: "tf": крупнее минуты сворачивайте 1m сами
from начало, мс, по ts. По умолчанию — сутки назад от to, у 1s — час
to конец, мс, не включительно. По умолчанию — сейчас; to в будущем шлюз сдвигает на «сейчас»
cursor курсор из next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/mark?instrument=binance:perp:BTCUSDT&tf=1m&from=1794531600000&to=1794531720000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1m",
  "columns": ["ts", "mark_open", "mark_high", "mark_low", "mark_close", "index_close", "premium", "secs"],
  "rows": [
    [1794531600000, "71111.39908546", "71137.9", "71045.18452774", "71045.18452774", "71084.41304348", -0.0005518581931035318, 60],
    [1794531660000, "71044.18909295", "71044.18909295", "70970.4", "71007.3", "71051.90695652", -0.0006278080129122655, 60]
  ],
  "next_cursor": null
}
Колонка Что
ts начало секунды или минуты, мс
mark (1s); mark_open, mark_high, mark_low, mark_close (1m) цена маркировки в валюте котировки — строкой, десятичная запись с точностью биржи
index (1s), index_close (1m) индексная цена, строкой, как mark. Нет у биржи — null. У Hyperliquid это оракульная цена (oraclePx)
premium mark / index − 1 (у 1m — по закрытию минуты): безразмерная доля, число. Без index — null
secs только у 1m: сколько секунд минуты имели значение, 1…60

Цены приходят строкой, чтобы не терять знаки: держите их строкой или десятичным типом, а не float, и не округляйте к шагу цены.

  • Секунды без строки держат прошлое значение: биржа шлёт только изменения. Протягивайте последнее известное.
  • Идущая минута в 1m не отдаётся — рисуйте её по секундам.
  • Секунды старше 7 суток не хранятся: окно tf=1s целиком старше — 400 bad_request с param: "from", частично — from подтягивается к краю хранения.
  • Страницы. Окно 1s длиннее часа и окно 1m длиннее недели шлюз режет и отдаёт next_cursor; страница — до 10 000 строк. У живого края, позже чем 2 минуты назад, курсора нет: следующий запрос начинайте с последней полученной строки.

Цены площадок не складываются: instruments= с двумя и больше инструментами — 400 bad_request.

GET/v1/mark/latest

Последняя секунда mark и index за 7 суток: одна строка с колонками tf=1s. Группа тарифа — mark.

Параметр Что
instrument обязательный, перп одной из бирж /v1/mark
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1s",
  "columns": ["ts", "mark", "index", "premium"],
  "rows": [[1794534182000, "70906.31457271", "70933.00695652", -0.00037630413477835085]],
  "next_cursor": null
}

Ни одной секунды за 7 суток — 404 not_found. Последние ~3 секунды источник может ещё не записать, поэтому чаще раза в секунду спрашивать незачем.