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

Ֆուտպրինտ և դելտա

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

1Ֆուտպրինտ և դելտա

footprint cluster-ներ — յուրաքանչյուր գնի մակարդակի վրա պատուհանների համաձայն՝ գնումների և վաճառքների ծավալը; ագրեսորի delta պատուհաններով՝ պատուհան ներսի էքստրեմումներով; Hyperliquid-ում դիրքերի բացում-փակում ըստ գնի մակարդակների։

Ֆուտպրինտ

GET/v1/footprint

footprint cluster-ներ՝ յուրաքանչյուր պատուհանի ժամանակահատվածի համար — ծավալներ գնի մակարդակներով, առանձին՝ բիդով և ասքով. Հարկային խումբ — footprint.

Պարամետր Ինչը
instrument պարտադիր
tf կլաստերի պատուհան՝ 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Լռելյայն 1m
from սկիզբ, մս. Լռելյայն — 60 պատուհան առաջ to-ից
to վերջ, մս, ներառյալ չէ
cursor cursор՝ next_cursor-ից

Պատասխանում երկու աղյուսակ են՝ levels — գնի մակարդակները, windows — պատուհանները:

JSON
{
  "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.

Դելտա

GET/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-ից
Shell
curl -s "https://market-api.lootx.trade/v1/delta?instrument=binance:perp:BTCUSDT&tf=5m&limit=1" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "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-ում դիրքերի բացում և փակել

GET/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-ից
Shell
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"
JSON
{
  "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.

https://docs.lootx.trade/hy/market-api/order-flow