← Դեպի փաստաթղթեր
LootX

open interest և funding rate

Կազմվել է: 2026-11-21 docs.lootx.trade
Справочник

1open interest և funding rate

Մինուտային բարեր open interest‑ի՝ դոլլարով, մոնետերով կամ բորսայի բնիկ միավորով; funding rate՝ ըստ րոպեների և դրանց հաշվարկները; long/short ratio՝ 5‑րոպեանոց բաքեթներով; mark և index՝ վայրկյաններով և րոպեներով.

Միայն պերպ կոնտրակտներ: market = perp. Բորսաներ: binance, bybit, okx, bitget, gate, mexc, bingx, kucoin, hyperliquid, aster, kraken, coinbase. long/short և mark և index բաժինների համար բորսաների հավաքածունները նշված են համապատասխան բաժիններում.

open interest

GET/v1/oi

open interest‑ի րոպեական բարեր՝ բացում, максимум, минимум և փակումը. Տարֆի խումբ — 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 — րոպեի սկիզբը. Էջը՝ մինչև մեկ շաբաթ րոպեների տվյալներ; երկար պատուհանների համար օգտագործեք կուրսորը.

funding rate

GET/v1/funding

Funding rate‑ը՝ այն, ինչ բորսան ցույց էր տալիս յուրաքանչյուր րոպե, և, երբ բորսան ասում է, հաջորդ հաշվարկի ժամանակը (next_funding_ts տողը; 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 — վճարման պարբերությունը ժամերով, ինչպես այն հաղորդում է աղբյուրը.

funding rate‑ի հաշվարկներ

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 կարող է լինել (տես վերև). Ձեր վճարները հաշվարկելու համար բազմապատկեք ставка‑ը դիրքի նոմինալով տվյալ պահին։ Մեզ մոտ և ձեր հաշվարկներում գումարները չեն հսկվում գնի քայլով՝ չ.round անեք։

Long/Short ratio

GET/v1/ls-ratio

Long/short հարաբերությունը և taker‑ների ծավալը 5‑րոպեանոց բաքեթներով՝ ինչպես դրանք հրապարակվում են բորսայով. Տարֆի խումբ — ls_ratio.

Պարամետր Ինչ
instrument պարտադիր, միայն պերպեր. Փնթի դիտորդներ կան՝ binance (global_account, top_account, top_position, taker_volume), bybit (global_account) և okx (նույն չորսը և global_account_ccy); մյուս open interest‑ի բորսաներում պատասխանն դատարկ է
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
}
Ստ conv Ինչ
ts բորսայի բաքեթի սկիզբ (bucket_ts), մս. Տողերը դասավորված են ըստ ts, ներսում՝ ըստ kind
as_of պահին նշված ժամանակը, մս. Binance‑ի global_account, top_account, top_position և Bybit‑ի global_account uchun as_of == ts (snapshot այդ պահը). Binance‑ի taker_volume և OKX‑ի բոլոր տեսակների համար as_of == ts + 5 րոպե՝ արժեքը շրջանին [ts, ts + 5 րոպե). Մյուս զույգերի համար as_of == ts. Տարբեր բորսաների և տեսակների շարքերը համախմբեք לפי as_of
long_ratio, short_ratio long-ների և short-ների բաժինները, առանց միավորի: 0.6849 == 68.49%
long_short_ratio long-ների ու short-ների հարաբերությունը; taker_volume-ի համար՝ գնողների (taker-ների) և վաճառողների հարաբերությունը
buy_vol, sell_vol taker-ների գնման և վաճառքի ծավալը բաքեթում — տող (բորսայի ճշգրիտ տասնորդական), միավորը՝ 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

Perp‑ի mark (mark price) և 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) mark գինը quote-արժույթով — տող (բորսայի ճշգրիտ տասնորդական)
index (1s), index_close (1m) index գինը՝ տողով, ինչպես 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/hy/market-api/oi-funding