← До документації
LootX

Відкритий інтерес і ставка фінансування

Зібрано: 2026-11-21 docs.lootx.trade
Справочник

1Відкритий інтерес і ставка фінансування

Хвилинні бари відкритого інтересу в доларах, монетах або рідній одиниці біржі; ставка фінансування по хвилинах і самі нарахування; 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

Самі моменти розрахунку: яка ставка застосувалася і за якою маркувальною ціною (mark). Та сама група 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 секунди джерело може ще не записати, тому питати частіше, ніж раз на секунду, немає сенсу.

https://docs.lootx.trade/uk/market-api/oi-funding