← Back to the docs
LootX

Trades

Generated: 2026-11-21 docs.lootx.trade
Справочник

1Trades

Time and sales from a size threshold — a hot layer for recent days and a perpetual archive of trades from $5,000 starting 11.09.2026.

GET/v1/trades

Trades one by one, with price, volume, value and aggressor side. Rate limit group — trades.

Parameter What
instrument required
from start, ms, inclusive. Default: one hour before to
to end, ms, exclusive
limit trades per page, 1–50,000, default 10,000
min_usd trade threshold in dollars (price × volume), inclusive: min_usd=5000 — only from $5,000
source storage layer: auto (default: recent days — hot, older — archive), hot, archive
cursor cursor from next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/trades?instrument=binance:perp:BTCUSDT&min_usd=100000&limit=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "source": "hot",
  "source_min_usd": 0,
  "min_usd": 100000,
  "columns": ["t", "price", "qty", "quote_qty", "side", "aggregated", "fills", "trade_id", "seq"],
  "rows": [
    [1793750412318, 104251.2, 1.25, 130314.0, "buy", true, 4, 6213554801, 18822107],
    [1793750431906, 104247.9, 2.004, 208912.7916, "sell", false, 1, 6213555367, 18822345]
  ],
  "next_cursor": "eyJ0IjoxNzkzNzUwNDMxOTA3fQ"
}
Column What
t trade time, ms
price price in quote currency
qty volume in coins
quote_qty trade value in quote currency, precision 0.0001 — not rounded to price step
side aggressor side: buy — bought, sell — sold
aggregated, fills true — several executions of one order merged into one trade; fills — how many
trade_id, seq trade_id — trade number at the exchange (0 if the exchange doesn’t provide it); seq — trade number within the same millisecond, populated only when trade_id = 0, otherwise 0

Pagination — by time, no repeats: if a page is cut in the middle of a millisecond, all trades of that millisecond go to the next page.

https://docs.lootx.trade/en/market-api/trades