Відкритий інтерес і ставка фінансування
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 свої набори бірж — вони названі в розділах.
Відкритий інтерес
/v1/oiХвилинні бари відкритого інтересу: відкриття, максимум, мінімум і закриття хвилини. Група тарифу — oi.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, тільки перпи |
from |
початок, мс. За замовчуванням — добу назад від to |
to |
кінець, мс, не включно |
unit |
usd (за замовчуванням), coins або native — як у біржі: монети, контракти або долари |
cursor |
курсор з next_cursor |
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"{
"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 — початок хвилини. Сторінка — до тижня хвилин; довгий період перегортайте курсором.
Ставка фінансування
/v1/fundingСтавка фінансування, як біржа показувала її кожну хвилину, з часом наступного нарахування там, де біржа його повідомляє (у Hyperliquid, MEXC, Kraken і Coinbase next_funding_ts — null). Група тарифу — funding.
| Параметр | Що |
|---|---|
instrument |
обов’язковий |
from, to, cursor |
вікно і курсор |
{
"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— період виплати, як його повідомляє джерело.
Нарахування ставки фінансування
/v1/funding/eventsСамі моменти розрахунку: яка ставка застосувалася і за якою маркувальною ціною (mark). Та сама група funding.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, тільки перпи |
from |
початок, мс. За замовчуванням — 30 діб назад від to |
to |
кінець, мс, не включно |
cursor |
курсор з next_cursor |
curl -s "https://market-api.lootx.trade/v1/funding/events?instrument=binance:perp:BTCUSDT" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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
/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.
curl -s "https://market-api.lootx.trade/v1/ls-ratio?instrument=binance:perp:BTCUSDT&from=1793278200000&to=1793278500000" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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 повністю потрапляють на одну сторінку.
/v1/ls-ratio/latestОстанній рядок кожного виду — або тільки виду kind — за 35 діб. Та сама група ls_ratio, ті самі колонки, next_cursor — null.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, тільки перпи |
kind |
вид ряду, як у /v1/ls-ratio. За замовчуванням — всі |
{
"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
/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 |
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"{
"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.
/v1/mark/latestОстання секунда mark і index за 7 діб: один рядок з колонками tf=1s. Група тарифу — mark.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, перп однієї з бірж /v1/mark |
{
"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