tardis-dev / tardis-machine

Locally runnable server with built-in data caching, providing both tick-level historical and consolidated real-time cryptocurrency market data via HTTP and WebSocket APIs
https://docs.tardis.dev/api/tardis-machine
Mozilla Public License 2.0
235 stars 46 forks source link

official document clarification #9

Closed thangng48 closed 2 years ago

thangng48 commented 2 years ago

As stated in [official document] (https://docs.tardis.dev/api/tardis-machine#normalized-data-types), tardis-machine supports 7 normalized types:

image

But in the source code, it supports more data types like:

And, I'd tried actual request to my tardis-machine, it returns normalized data, for instance of liquidation:

exchanges=("bitmex" "binance-futures" "binance-delivery" "bitfinex-derivatives" "deribit" "ftx" "huobi-dm" "huobi-dm-swap" "huobi-dm-linear-swap")
for ex in ${exchanges[@]}; do 
  count=$(curl -g "http://localhost:8000/replay-normalized?options={\"exchange\":\"${ex}\",\"from\":\"2021-11-30\",\"to\":\"2021-12-01\",\"withDisconnectMessages\":false,\"dataTypes\":[\"liquidation\"]}" | wc -l)
  echo "${ex} = ${count}"
done;

bitmex = 144
binance-futures = 40810
binance-delivery = 1709
bitfinex-derivatives = 78
deribit = 266
ftx = 20745
huobi-dm = 34
huobi-dm-swap = 150
huobi-dm-linear-swap = 1287

Are there any inconsistent between the actual behavior and documentation, or I misunderstood some points in your docs or source code ? Please clarify it. Thanks !

thaaddeus commented 2 years ago

Hi, yes docs simply aren't up to date, new data types not documented are liquidation (same format as trade), option_summary (fields are documented at https://docs.tardis.dev/downloadable-csv-files#options_chain) and book_ticker which is like quote but using native tickers/quotes/book_ticker channels of exchanges when supported. Docs update is on the roadmap, should be finished in Q1 2021.

thangng48 commented 2 years ago

@thaaddeus

Thank you for confirming it. Closing this issue.