open 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
/v1/oiopen interest‑ի րոպեական բարեր՝ բացում, максимум, минимум և փակումը. Տարֆի խումբ — 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 — րոպեի սկիզբը. Էջը՝ մինչև մեկ շաբաթ րոպեների տվյալներ; երկար պատուհանների համար օգտագործեք կուրսորը.
funding rate
/v1/fundingFunding rate‑ը՝ այն, ինչ բորսան ցույց էր տալիս յուրաքանչյուր րոպե, և, երբ բորսան ասում է, հաջորդ հաշվարկի ժամանակը (next_funding_ts տողը; 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— վճարման պարբերությունը ժամերով, ինչպես այն հաղորդում է աղբյուրը.
funding rate‑ի հաշվարկներ
/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 կարող է լինել (տես վերև). Ձեր վճարները հաշվարկելու համար բազմապատկեք ставка‑ը դիրքի նոմինալով տվյալ պահին։ Մեզ մոտ և ձեր հաշվարկներում գումարները չեն հսկվում գնի քայլով՝ չ.round անեք։
Long/Short ratio
/v1/ls-ratioLong/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-ով։
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
}| Ստ 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‑ի բոլոր տողերը ամբողջությամբ տեղափոխվում են մեկ էջին.
/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/markPerp‑ի 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-ից |
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) |
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։
/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 վայրկյանը աղբյուրը կարող է դեռ չգրանցել, այդ պատճառով հաճախ ավելի քան մեկ անգամ վայրկյանին հարցնելը անհրաժեշտ չէ.