Открытый интерес и фандинг
Минутные бары открытого интереса в долларах, монетах или родной единице биржи; ставка фандинга по минутам и сами начисления; 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Сами моменты расчёта: какая ставка применилась и по какой цене маркировки. Та же группа 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 секунды источник может ещё не записать, поэтому чаще раза в секунду спрашивать незачем.