Գործիքներ, ժամանակ և էջեր
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։ Թե որ քայլերն է ընդունում երթուղին, նկարագրված է նրա բաժնում։
from datetime import datetime, timezone
t0 = int(datetime(2026, 11, 4, tzinfo=timezone.utc).timestamp() * 1000) # 1793750400000Պատասխանը՝ աղյուսակ սյունակներով
Տողերը գալիս են ոչ թե օբյեկտների զանգվածով, այլ աղյուսակով․ սյունակների անունները մեկ անգամ են, տողերը՝ արժեքների զանգվածներ նույն հերթականությամբ։ Այսպես պատասխանը մի քանի անգամ կարճ է։
{
"instrument": "binance:perp:BTCUSDT",
"columns": ["ts", "open", "high", "low", "close"],
"rows": [[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3]],
"next_cursor": null
}Սովորական օբյեկտների վերածելը մեկ տող է․
const records = body.rows.map((r) => Object.fromEntries(body.columns.map((c, i) => [c, r[i]])));Պատասխանում դաշտերը կարող են ավելանալ, մի հիմնվեք դրանց հերթականության վրա և մի վթարեք անծանոթ դաշտի դեպքում։ Սյունակների հերթականությունը աղյուսակի ներսում սահմանում է columns-ը։
Էջեր
Եթե պատասխանը մեկ էջում չի տեղավորվել, դրա մեջ կա next_cursor։ Փոխանցեք այն որպես cursor= մյուս բոլոր պարամետրերը նույնությամբ թողած, կստանաք հաջորդ էջը։ next_cursor: null - էջեր այլևս չկան։
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դաշտում (ձևաչափեր)։
Link: <https://market-api.lootx.trade/v1/candles?instrument=binance:perp:BTCUSDT&tf=1m&cursor=YzE6MTc5MTMzMTMyMDAwMA>; rel="next"
X-Next-Cursor: YzE6MTc5MTMzMTMyMDAwMALink-ի հասցեն նույն հարցումն է նոր 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