Ֆուտպրինտ և դելտա
footprint cluster-ներ — յուրաքանչյուր գնի մակարդակի վրա պատուհանների համաձայն՝ գնումների և վաճառքների ծավալը; ագրեսորի delta պատուհաններով՝ պատուհան ներսի էքստրեմումներով; Hyperliquid-ում դիրքերի բացում-փակում ըստ գնի մակարդակների։
Ֆուտպրինտ
/v1/footprintfootprint cluster-ներ՝ յուրաքանչյուր պատուհանի ժամանակահատվածի համար — ծավալներ գնի մակարդակներով, առանձին՝ բիդով և ասքով. Հարկային խումբ — footprint.
| Պարամետր | Ինչը |
|---|---|
instrument |
պարտադիր |
tf |
կլաստերի պատուհան՝ 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Լռելյայն 1m |
from |
սկիզբ, մս. Լռելյայն — 60 պատուհան առաջ to-ից |
to |
վերջ, մս, ներառյալ չէ |
cursor |
cursор՝ next_cursor-ից |
Պատասխանում երկու աղյուսակ են՝ levels — գնի մակարդակները, windows — պատուհանները:
{
"instrument": "binance:perp:BTCUSDT",
"tf": "1m",
"windows": {
"columns": ["ts", "open", "high", "low", "close", "closed"],
"rows": [[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3, true]]
},
"levels": {
"columns": ["ts", "price", "bid_qty", "ask_qty", "trades", "trades_buy", "trades_sell"],
"rows": [
[1793750400000, 104250.5, 1.204, 0.832, 41, 23, 18],
[1793750400000, 104250.6, 0.317, 2.115, 37, 12, 25]
]
},
"next_cursor": null
}ts՝ մակարդակի վրա — այն պատուհանի սկիզբը, որի հետ այն կապված է;bid_qty— ծավալը, որտեղ ագրեսորը գնել է,ask_qty— որտեղ ագրեսորը վաճառել է; մոնետաներով. Սյունակների անունները համապատասխանում են ագրեսորի կողմին, ոչ թե order book-ի կողմին, որի մեջ ընկել է գործարքը. Ստուգեք դա՝ եթե տեղափոխում եք հաշվարկները մյուս պլատֆորմից;trades_buy,trades_sell— քանի առք/վաճառք էtrades-ից կատարվել ագրեսորի կողմից, նույն կողմերը, ինչbid_qtyևask_qty. Եթե արժեքները հայտնի են,trades_buy + trades_sell = trades. Եթե երկուսն էլnullեն, ապա բաժանման տվյալներ չկան՝ կամ դա պատմություն է մինչև կողմերի գրանցումը, կամ այն պատուհանն է (5m…1d), որի մեջ ընկած է այդ րոպեն. Սա չի նշանակում «ոչ մի գնում չի եղել». Սյունակները՝ ավարտին են, առաջին հինգը մնացել են տեղում;closed: true— պատուհանը փակված է և այլևս չի փոխվի. վերջին պատուհանը, «Հիմա»-ի համար, կարող է գալclosed: falseև հետո աճել։
Պատուհաններ մեկ էջում — մինչև 2000. CSV-ը ամբարգում է միայն մեկ աղյուսակ, ապա ֆուտպրինտի համար ընտրեք՝ ?format=csv&table=levels կամ table=windows.
Դելտա
/v1/deltaԱգրեսորի delta պատուհաններով՝ գնողներ, վաճառողներ, նրանց տարբերությունը և պատուհան ներսի վազող delta-ի էքստրեմումները — մոնետաներով և quote-արժույթով. Հարկային խումբ — delta.
| Պարամետր | Ինչը |
|---|---|
instrument |
պարտադիր |
tf |
պատուհան՝ 1s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Լռելյայն 1m |
from |
սկիզբ, մս; հավասարեցվում է պատուհանի սկիզբին. Լռելյայն — limit պատուհան անցյալից to-ից |
to |
վերջ, մս, ներառյալ չէ |
limit |
պատուհաններ մեկ էջի համար, 1–10 000, լռելյայն 1000 |
cursor |
cursор՝ next_cursor-ից |
curl -s "https://market-api.lootx.trade/v1/delta?instrument=binance:perp:BTCUSDT&tf=5m&limit=1" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"instrument": "binance:perp:BTCUSDT",
"tf": "5m",
"columns": ["t", "buy", "sell", "delta", "delta_min", "delta_max", "trades",
"buy_quote", "sell_quote", "delta_quote", "delta_quote_min", "delta_quote_max",
"close", "closed"],
"rows": [[1793750400000, 97.12, 85.31, 11.81, -4.06, 15.27, 8410,
10127740.0512, 8894144.2587, 1233595.7925, -423187.164, 1592311.0033,
104288.7, true]],
"next_cursor": null
}| Սյունակ | Ինչը |
|---|---|
t |
պատուհանի սկիզբ, մս |
buy, sell, delta |
ագրեսորի գնման և վաճառքի ծավալները և դրանց տարբերությունը՝ մոնետաներով |
delta_min, delta_max |
վազող delta-ի նվազագույն և առավելագույն արժեքները պատուհան ներսում, մոնետաներով |
buy_quote … delta_quote_max |
նույնը՝ գումարով (quote-արժույթում); ճշգրտությունը՝ 0.0001, առանց օղակավորման դեպի price step |
close |
պատուհանի փակման գին |
closed |
պատուհանը փակված է |
Պատուհաններ առանց միակ գործարքի չեն գալիս՝ ժամանակահատվածում բացթողումը շուկայի լռություն է, ոչ տվյալների կորուստ։
Hyperliquid-ում դիրքերի բացում և փակել
/v1/hyperliquid/footprintՖուտպրինտ NL/NS՝ յուրաքանչյուր գնի մակարդակում Hyperliquid-ում՝ թե որքան են ավելացել կամ նվազել long-ները և short-ները, առանձին՝ taker-ների և maker-ների համար. Սրան հաշվարկվում է Hyperliquid nodes-ի լցոնումներից (լցոնում)՝ ըստ մասնակցի դիրքի մինչ ու հետո յուրաքանչյուր լցոնման. Հարկային խումբ — footprint.
| Պարամետր | Ինչը |
|---|---|
instrument |
պարտադիր, պերպ Hyperliquid-ի համար: hyperliquid:perp:BTC, HIP-3 շուկան — hyperliquid:perp:AAPLUSDC.XYZ կամ կարճ hyperliquid:perp:AAPL.XYZ. Ավելի այլ բորսա կամ spot — 400 unsupported_instrument |
tf |
պատուհան՝ 1m, 5m, 15m, 30m, 1h, 4h, 1d. Լռելյայն 1m. Վայրկյաններ չկան — այլ քայլի համար վերադարձնի 400 bad_request՝ param: "tf" |
from |
սկիզբ, մս; հավասարեցվում է պատուհանի սկիզբին. Լռելյայն — 60 պատուհան առաջ to-ից |
to |
վերջ, մս, ներառյալ չէ |
cursor |
cursор՝ next_cursor-ից |
curl -s "https://market-api.lootx.trade/v1/hyperliquid/footprint?instrument=hyperliquid:perp:BTC&tf=1m&from=1794500100000&to=1794500220000" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"instrument": "hyperliquid:perp:BTC",
"tf": "1m",
"levels": {
"columns": ["ts", "price", "dl_taker", "ds_taker", "dl_maker", "ds_maker", "n_fills"],
"rows": [
[1794500100000, 68960.5, 0.001, 0.0, 0.0, 0.001, 4],
[1794500100000, 68961.0, -0.0005, 0.0003, 0.0008, 0.0, 2],
[1794500160000, 68960.0, 0.0, -0.0002, -0.0001, 0.0001, 2]
],
"next_cursor": null
},
"windows": {
"columns": ["ts", "closed"],
"rows": [[1794500100000, true], [1794500160000, false]],
"next_cursor": null
},
"asof_ms": 1794500205000,
"next_cursor": null
}| Սյունակ | Ինչը |
|---|---|
ts |
պատուհանի սկիզբ, մս |
price |
գնի մակարդակ |
dl_taker, ds_taker |
taker-ների long-ների և short-ների փոփոխությունը այդ մակարդակում, մոնետաներով. Դրական — բացեցին, բացասական — փակեցին |
dl_maker, ds_maker |
նույնը maker-ների համար |
n_fills |
քանի լցոնում է եղել այդ մակարդակում; լցոնումը (fill) — գործարքի կեսը, համապատասխան match-ի մեկ կողմը |
Երեք տեսակի NL/NS հաշվարկվում են չորս սյունակից՝ բոլոր մասնակիցների դեպքում dl_taker + dl_maker (և նույնը՝ ds_taker + ds_maker) — դա տվյալ մակարդակում open interest-ի փոփոխությունն է; taker-ների համար՝ dl_taker և ds_taker; maker-ների համար՝ dl_maker և ds_maker. Պատասխանում գումարներ փողով չկան՝ գինն ու քանակը նշված են ինստրումենտով.
windows— պատուհաններ՝closed-ով:true— պատուհանը փակված է և այլևս չի փոխվի; «հիմա»-ի համար կարող է գալfalse.asof_ms— այն պահը, մինչև երբ աղբյուրը գրանցել է ամբողջական րոպեները.instrumentպատասխանում — մոնետայի կանոնական անունը, ոչ հարցման ձևը: օրինակ՝hyperliquid:perp:aapl.xyzփոխարեն կգաhyperliquid:perp:AAPLUSDC.XYZ, իսկhyperliquid:perp:BTCUSDCփոխարեն՝hyperliquid:perp:BTC.- gateway-ի անունը ստուգվում է միայն ձևով — լատինատառ տառեր և թվեր, մինչև 32 նիշ, HIP-3 շուկաներում կարող է ունենալ դոմենից հետո կետ. Այն, թե կա՞ նման մոնետա Hyperliquid-ում, չի ստուգվում.
- Պատուհաններ մեկ էջում — մինչև 2000, այնուհետև՝
next_cursor. Եթե մեկ պատուհանը ավելի մեծ է, քան տվյալ աղբյուրի տողերի մաքսիմումը — վերադարձնվում է413 too_large, վերցրեք փոքրtf. - Պլատֆորմների գումարը չի տրամադրվում:
instruments=-ով երկու և ավել ինստրումենտ ուղարկելը՝ վերադարձնում է400 bad_request.