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

Գործիքներ, ժամանակ և էջեր

Կազմվել է: 2026-11-21 docs.lootx.trade
Начало работы

1Գործիքներ, ժամանակ և էջեր

Երեք կանոն՝ ընդհանուր բոլոր երթուղիների համար․ գործիքի անունը venue:market:SYMBOL, ժամանակը UTC միլիվայրկյաններով և թերթում next_cursor-ի միջոցով։

API-ի բոլոր երթուղիները խոսում են մեկ լեզվով․ գործիքը նույն անունն ունի ցանկացած բորսայում և ցանկացած աղբյուրում, ժամանակը միշտ Unix-միլիվայրկյաններ է UTC, երկար պատասխանը թերթվում է cursor-ով։ Այստեղ այս երեք կանոնները մեկ անգամ և մանրամասն։

Գործիքի անունը

Գործիքը գրվում է venue:market:SYMBOL ձևաչափով․

Օրինակ Ինչ է սա
binance:perp:BTCUSDT Բինանսում BTC-ի USDT անժամկետ կոնտրակտ
bybit:spot:ETHUSDT ETH/USDT սփոթ Bybit-ում
hyperliquid:perp:BTC BTC պերպ Hyperliquid-ում, այս բորսայում պերպը մոնետա է կոչվում
coinbase:spot:BTC-USD BTC/USD սփոթ Coinbase-ում, գծիկով, ինչպես հենց բորսայում
lighter:perp:BTCUSDC BTC պերպ Lighter-ում, հաշվարկը USDC-ով
hyperliquid:perp:AAPLUSDC.XYZ Apple-ի բաժնետոմս Hyperliquid-ի xyz դեքում (HIP-3 շուկա), տվյալներ կան ոչ բոլոր երթուղիներում
  • venue - բորսան փոքրատառերով․ binance, bybit, okx, bitget, gate, mexc, bingx, kucoin, hyperliquid, aster, lighter, kraken, coinbase, upbit և այլն։ Թե որ բորսան ինչ տեսակի տվյալներ ունի, տարբեր է, ամբողջական ցանկը՝ /v1/instruments։
  • market - spot կամ perp։ Անունը future կամ option վերլուծվում է, բայց դրանց վերաբերյալ տվյալներ չկան, նման հարցումը ստանում է 400 unsupported_instrument։
  • SYMBOL - բազան և quote-ը միասին, մեծատառերով․ BTCUSDT, ETHUSDC։ Բացառությունները Hyperliquid-ն ու Coinbase-ն են, ինչպես աղյուսակում։

Անվան սխալ ձևը 400 bad_instrument է։ Անունը ճիշտ է, բայց երթուղին այդպիսի շուկա կամ բորսա չգիտի՝ 400 unsupported_instrument param: "instrument"-ով։ Սիմվոլը ստուգում են միայն /v1/candles-ը և /v1/series-ը, այն էլ ոչ միշտ․ զույգը, որը աղբյուրում չկա, կարող է այնտեղ ստանալ 400 unsupported_instrument param: "symbol"-ով, իսկ աղբյուրի խափանման դեպքում՝ դատարկ 200։ Մյուս երթուղիներում սիմվոլը ռեեստրի հետ չի ստուգվում․ զույգը և տառասխալ անունը, որոնք անցել են բորսայի, շուկայի և quote-ի ստուգումը, ստանում են 200 առանց տողերի։ Ստուգեք անունը ռեեստրով, մերժման պայմաններն ու բացառությունները՝ սխալների էջում։

Ժամանակ

  • Ժամանակն ամենուր Unix-միլիվայրկյաններ է UTC-ով, ամբողջ թիվ․ 1793750400000 - 2026 թ. նոյեմբերի 4, 00:00 UTC։
  • Հարցման պատուհանը կիսաբաց է [from, to)․ from-ը ներառվում է, to-ն՝ ոչ։ Այսպես հարակից պատուհանները միանում են առանց կրկնությունների։
  • Յուրաքանչյուր երթուղի ունի իր լռելյայն արժեքները․ մոմերն առանց from-ի վերցնում են limit քայլ հետ to-ից, գործարքները՝ վերջին ժամը, open interest-ը՝ վերջին օրը։ Առանց to-ի՝ «հիմա»։
  • Քայլը (tf) գրվում է թվով վերջածանցով․ 1s, 30s, 1m, 5m, 1h, 4h, 1d։ Թե որ քայլերն է ընդունում երթուղին, նկարագրված է նրա բաժնում։
Python
from datetime import datetime, timezone

t0 = int(datetime(2026, 11, 4, tzinfo=timezone.utc).timestamp() * 1000)  # 1793750400000

Պատասխանը՝ աղյուսակ սյունակներով

Տողերը գալիս են ոչ թե օբյեկտների զանգվածով, այլ աղյուսակով․ սյունակների անունները մեկ անգամ են, տողերը՝ արժեքների զանգվածներ նույն հերթականությամբ։ Այսպես պատասխանը մի քանի անգամ կարճ է։

JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "columns": ["ts", "open", "high", "low", "close"],
  "rows": [[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3]],
  "next_cursor": null
}

Սովորական օբյեկտների վերածելը մեկ տող է․

JavaScript
const records = body.rows.map((r) => Object.fromEntries(body.columns.map((c, i) => [c, r[i]])));

Պատասխանում դաշտերը կարող են ավելանալ, մի հիմնվեք դրանց հերթականության վրա և մի վթարեք անծանոթ դաշտի դեպքում։ Սյունակների հերթականությունը աղյուսակի ներսում սահմանում է columns-ը։

Էջեր

Եթե պատասխանը մեկ էջում չի տեղավորվել, դրա մեջ կա next_cursor։ Փոխանցեք այն որպես cursor= մյուս բոլոր պարամետրերը նույնությամբ թողած, կստանաք հաջորդ էջը։ next_cursor: null - էջեր այլևս չկան։

Python
import os, requests

URL = "https://market-api.lootx.trade/v1/trades"
HEAD = {"Authorization": f"Bearer {os.environ['LOOTX_API_KEY']}"}
params = {"instrument": "binance:perp:BTCUSDT", "from": 1793750400000, "to": 1793754000000}

rows = []
while True:
    page = requests.get(URL, params=params, headers=HEAD, timeout=30).json()
    rows += page["rows"]
    if not page.get("next_cursor"):
        break
    params["cursor"] = page["next_cursor"]
  • Cursor-ը անթափանց տող է, ներսում միայն շարունակության դիրքն է։ Gateway-ը չի ստուգում մյուս պարամետրերը առաջին էջի հետ համապատասխանեցնելով․ այլ պարամետրերով էջը կկառուցվի դրանցով այդ դիրքից։ Ուստի cursor-ը փոխանցեք նույն instrument-ով, tf-ով, to-ով, limit-ով և մնացածով։ 400 bad_cursor - միայն եթե cursor-ը վնասված է։
  • Մոմերը էջերի են բաժանվում քայլի ցանցով, իսկ գործարքների դեպքում մեկ միլիվայրկյանի բոլոր գրառումներն ամբողջությամբ մեկ էջ են գնում, հանգույցում կրկնություններ և բացթողումներ չկան։
  • Ուղղությունը երթուղիների մեծ մասում հնից նորին է։ Բացառություն․ liquidity walls-ի պատմությունը թերթվում է թարմից հնին։
  • Ցանկացած ձևաչափում հաջորդ էջը կա նաև վերնագրերում․ X-Next-Cursor-ը cursor-ն է, Link-ը՝ հաջորդ էջի պատրաստի հասցեն (RFC 8288)։ CSV-ում cursor-ը միայն վերնագրում է, protobuf-ում՝ նաև next_cursor դաշտում (ձևաչափեր)։
HTTP
Link: <https://market-api.lootx.trade/v1/candles?instrument=binance:perp:BTCUSDT&tf=1m&cursor=YzE6MTc5MTMzMTMyMDAwMA>; rel="next"
X-Next-Cursor: YzE6MTc5MTMzMTMyMDAwMA

Link-ի հասցեն նույն հարցումն է նոր cursor-ով․ կարող եք գնալ դրանով՝ ոչինչ չհավաքելով։ Վերջին էջը Link և X-Next-Cursor վերնագրեր չի կրում։

Վերնագրեր, որոնք արժե լոգավորել

Վերնագիր Ինչու
X-Request-Id հարցման համարը, նույնը, ինչ request_id-ն սխալի մարմնում։ Ուղարկեք այն աջակցությանը
X-RateLimit-Remaining քանի հարցում է մնացել ամենասեղմ սահմանաչափում, մանրամասն
X-Cache կա միայն այն պատասխաններում, որոնք gateway-ը կարող է cache-ավորել (փակ դիապազոններ)․ HIT - gateway-ի հիշողությունից, MISS - աղբյուրից։ Փակ դիապազոնները gateway-ը հիշում է մինչև 10 րոպե։ Մյուս պատասխաններում այս վերնագիրը չկա
RateLimit մնացորդը և վայրկյանները մինչև զրոյացում սակագնի բոլոր պատուհաններով, մանրամասն

X-Request-Id-ը gateway-ը դնում է ինքը յուրաքանչյուր պատասխանի վրա, դա այն համարն է, որով մենք կգտնենք հարցումը։

Սեղմում

Պատասխանները սեղմվում են, եթե հաճախորդը դա խնդրում է․ Accept-Encoding: gzip կամ br։ curl-ը խնդրում է --compressed-ով, requests-ը և բրաուզերը՝ ինքնաբերաբար։ Ջերմաքարտեզի binary-ն (HMP1/HMP2) չի սեղմվում, այն առանց այդ էլ խիտ է։

Սակագնի օրական ծավալը հաշվվում է մինչև սեղմումը մարմնով․ հարցումը նույն արժեքն ունի սեղմմամբ և առանց դրա, իսկ սեղմումը խնայում է միայն ժամանակ և տրաֆիկ։

https://docs.lootx.trade/hy/market-api/conventions