Գործիքներ և վիճակ
Ինչ գործիքներ կան և տվյալների որ տեսակներում՝ ռեեստր /v1/instruments, աղբյուրները առողջ են արդյոք՝ /v1/status։
Սակագնի խումբը՝ instruments։ Սկսեք ռեեստրից. այն ցույց է տալիս, թե ինչպես է կոչվում գործիքը և որ ուղիներով կան տվյալներ դրա վերաբերյալ։
Գործիքների ռեեստր
/v1/instrumentsԲոլոր աղբյուրների բոլոր գործիքները մեկ կանոնական անվամբ։ sources սյունակը ցույց է տալիս, թե որտեղ կա տվյալ գործիքը՝ candles, footprint, densities, screener։
| Պարամետր | Ինչ է |
|---|---|
venue |
բորսա՝ binance, okx, … |
market |
spot կամ perp։ Ամսաթվով ֆյուչերսներ և օպցիոններ դեռ չկան |
source |
միայն այն գործիքները, որոնց համար կան տվյալներ այս տեսակով՝ candles, footprint, densities, screener |
q |
սիմվոլի ենթատող՝ առանց ռեգիստրի հաշվի առնելու՝ q=btc |
limit |
տողեր մեկ էջում, 1–10 000, լռելյայն՝ 1000 |
cursor |
կուրսոր next_cursor-ից |
curl -s "https://market-api.lootx.trade/v1/instruments?venue=binance&market=perp&q=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"columns": ["instrument", "venue", "market", "symbol", "sources"],
"rows": [
["binance:perp:BTCUSDT", "binance", "perp", "BTCUSDT", ["candles", "footprint", "densities", "screener"]],
["binance:perp:BTCUSDC", "binance", "perp", "BTCUSDC", ["candles", "footprint", "densities"]]
],
"next_cursor": null,
"updated_at": 1793750400000
}updated_at-ը ցույց է տալիս, թե երբ է gateway-ը վերջին անգամ ստացել ցուցակը գոնե մեկ աղբյուրից, 0՝ դեռ ոչ մի անգամ։ Ռեեստրը թարմացվում է 5 րոպեն մեկ և ցույց է տալիս այն, ինչ աղբյուրները հավաքում են հենց հիմա, այլ ոչ բորսաների բոլոր լիստինգները։ Նոր զույգը կհայտնվի, երբ այն սկսի հավաքել աղբյուրը. աղբյուրների մի մասի մոտ դա տեղի է ունենում օրական շրջանառության շեմից հետո։
Աղբյուրների վիճակ
/v1/statusԱրդյոք gateway-ի հետևում տվյալների աղբյուրները պատասխանում են և ինչ ուշացումով։ Հարմար է ձեր մոնիտորինգի համար. եթե ok: false, ապա այդ աղբյուրի ուղիներով 502/504 սխալները սպասելի են։
{
"ok": true,
"ts": 1793750400000,
"upstreams": [
{ "name": "data", "ok": true, "latency_ms": 12, "http_status": 200 },
{ "name": "clusters", "ok": true, "latency_ms": 18, "http_status": 200 }
]
}/v1/status-ը աղյուսակ չունի, հետևաբար CSV էլ չկա՝ միայն JSON և protobuf։ Ուղին չի մտնում սակագնի որևէ խմբի մեջ և ծախսում է միայն ընդհանուր սահմանաչափերը։