Інструменти та стан
Які є інструменти та в яких видах даних — реєстр /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 — коли шлюз востаннє отримав список хоча б від одного джерела, 0 — ще жодного разу. Реєстр оновлюється раз на 5 хвилин і показує те, що джерела збирають прямо зараз, а не всі лістинги бірж. Нова пара з’явиться, коли її почне збирати джерело; у частини джерел це відбувається після порога добового обороту.
Стан джерел
/v1/statusЧи відповідають джерела даних за шлюзом і з якою затримкою. Зручно для власного моніторингу: якщо 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. Маршрут не входить до жодної групи тарифу і витрачає тільки загальні ліміти.