Խտություններ և այսբերգներ
Խոշոր լիմիտային պատերը order book-ում հենց հիմա, հանված և կերված պատերի պատմությունը (պահվում է մինչև 90 օր), այսբերգները և կլանումները։
Խտությունը խոշոր լիմիտային հայտ է (պատ), որը նկատելիորեն մեծ է հարևան մակարդակների սովորական ծավալից։ Խտությունների ծառայությունը հետևում է բորսաների order book-ներին և պատերը տալիս է անմիջապես դոլարային չափով, գնից հեռավորությամբ և տարիքով։
Կենդանի խտություններ
/v1/densitiesՊատերի ընթացիկ պատկերը․ մեկ գործիքով կամ շուկայի ամփոփմամբ։ Սակագնի խումբը՝ densities։
| Պարամետր | Ինչ է |
|---|---|
instrument |
մեկ գործիք։ Առանց դրա՝ շուկայի ամփոփում՝ ստորև բերված ֆիլտրերով |
venue |
բորսաներ ստորակետով՝ binance,bybit |
market |
շուկաներ ստորակետով՝ spot, perp |
coins |
մետաղադրամներ ստորակետով՝ BTC,ETH — ոչ սիմվոլներ |
side |
bid կամ ask |
min_usd |
պատի նվազագույն չափը, $ |
max_dist_bp |
առավելագույն հեռավորությունը order book-ի միջնակետից, բազիսային կետեր․ 200 = ±2 % |
limit |
քանի պատ, լռելյայն 200 |
sort |
usd (լռելյայն), age, dist |
curl -s "https://market-api.lootx.trade/v1/densities?coins=BTC&market=perp&min_usd=1000000&limit=2" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"ts": 1793750400000,
"columns": ["instrument", "side", "price", "qty", "usd", "dist_bp", "first_ts", "age_ms",
"peak_usd", "state", "touched", "size", "score", "agg", "wall_id"],
"rows": [
["binance:perp:BTCUSDT", "bid", 103500.0, 41.8, 4326300.0, -72, 1793741112000, 9288000,
4512000.0, "live", false, "strong", 2.37, "tick", "11658847687750313317"]
],
"next_cursor": null
}| Սյունակ | Ինչ է |
|---|---|
side |
bid — գնում, ask — վաճառք |
price, qty, usd |
գին, ծավալը մետաղադրամներով և պատի չափը դոլարով |
dist_bp |
հեռավորությունը order book-ի միջնակետից նշանով, բ․ կ․․ մինուս — միջնակետից ցածր (սովորաբար bid-եր), պլյուս — վերև (ask-եր)։ max_dist_bp ֆիլտրը համեմատում է մոդուլը |
first_ts, age_ms |
երբ է պատը հայտնվել և որքան է արդեն կանգնած |
peak_usd |
պատի ամենամեծ չափը իր կյանքի ընթացքում |
state |
live — կանգնած է առանց նկատելի փոփոխության, updated — չափը նկատելիորեն փոխվել է նախորդ պատկերի համեմատ |
touched |
պատի գնով արդեն գործարքներ են անցել, որոնք նրան ուտում են |
size |
normal, weak, optimal, strong — չափի աստիճանը զույգի liquidity-ի նկատմամբ․ normal — խտություն կա, բայց թույլ աստիճանից ցածր է |
score |
խոշորության չափանիշ․ 1 — optimal շեմ, 2 — strong շեմ, 0 — չի հաշվվել |
agg |
tick — պատը մեկ մակարդակում, natr — մակարդակները սոսնձված են ըստ volatility-ի |
wall_id |
պատի համարը տողով․ դա 64-բիթանոց թիվ է, JavaScript-ում այն չի տեղավորվում number-ի մեջ առանց կորստի |
Ամփոփումը դասավորված է ըստ usd-ի, ts-ը պատկերի պահն է։ Պատկերը կենդանի է․ խտությունների քեշ չկա, յուրաքանչյուր հարցում թարմ վիճակ է։ Շարունակական հետևման համար վերցրեք densities ալիքը WebSocket-ում․ ըստ գործիքների ցանկի կամ ամբողջ շուկան ֆիլտրերով։ Փոփոխությունները գալիս են ինքնուրույն, առանց հարցման․ կադրերի բայթերը մտնում են օրական ծավալի մեջ REST-ի հետ միասին։
Խտությունների պատմություն
/v1/densities/historyՓակ պատեր․ հանված (pulled) և գործարքներով կերված (eaten)։ Պահվում են մինչև 90 օր։ Սակագնի խումբը՝ densities_history։
| Պարամետր | Ինչ է |
|---|---|
instrument |
պարտադիր |
from |
սկիզբը պատի հայտնվելու պահով, մվ։ Լռելյայն՝ մեկ օր առաջ to-ից |
to |
վերջ, մվ, չներառյալ |
kind |
pulled, eaten կամ երկուսն էլ ստորակետով (լռելյայն) |
limit |
պատեր էջում, 1–10 000, լռելյայն 1000 |
cursor |
կուրսոր․ էջերը գնում են թարմից հին |
{
"instrument": "binance:perp:BTCUSDT",
"columns": ["t", "side", "kind", "price", "qty_open", "qty_close", "usd_open", "usd_peak",
"end_ts", "duration_ms", "dist_bp_open", "mid_at_close", "touched", "size"],
"rows": [
[1793741112000, "bid", "eaten", 103500.0, 41.8, 0.0, 4326300.0, 4512000.0,
1793752004000, 10892000, -72, 103498.6, true, "S"]
],
"next_cursor": null
}t — պատի հայտնվելը, end_ts — երբ այն վերացավ․ qty_open/qty_close — ծավալը սկզբում և վերջում, mid_at_close — order book-ի միջնակետը փակման պահին։ size-ը պատմության մեջ կարճ կոդ է․ "" — առանց աստիճանի, W — weak, O — optimal, S — strong։
Պատմության մեջ գրվում են սեղմված order book-ի պատերը (agg = natr), ոչ թե առանձին մակարդակների․ գինը և չափը չեն համընկնում կենդանի պատկերի պատերի հետ (այնտեղ լռելյայն tick է), իսկ wall_id պատմության մեջ չկա — փակ պատը կենդանու հետ համարով կապել հնարավոր չէ։
Այսբերգներ և կլանումներ
/v1/icebergsԹաքնված հայտեր, որոնք լրացվում են մաս-մաս (iceberg), և մակարդակներ, որոնք կլանում են շուկայական հոսքը (absorption)։ Սակագնի խումբը՝ icebergs։
| Պարամետր | Ինչ է |
|---|---|
instrument |
մեկ գործիք։ Առանց դրա՝ ըստ շուկայի՝ ֆիլտրերով |
venue, market, coins, side |
ֆիլտրեր, ինչպես խտությունների դեպքում․ coins — մինչև 100 |
kind |
iceberg, absorption կամ all (լռելյայն) |
min_usd |
նվազագույն թաքնված կատարված ծավալ, $ |
state |
active (լռելյայն — ընթացիկ), ended (ավարտված) կամ all |
limit |
1–5000, լռելյայն 200 |
Սյունակներ․ instrument, id (տողով — 64-բիթանոց թիվ), side, kind, price, first_ts, last_ts, trades, executed_qty, hidden_qty, visible_max, clip_qty (մետաղադրամներ), executed_usd, hidden_usd ($․ թաքնված ծավալը ստորին գնահատական է), refills, end (null — դեռ ընթացքի մեջ է, այլապես idle, broken կամ reset)։