QuantLake
GitHub
Documentation

Troubleshooting

Common problems and how to fix them.

"Operation not permitted" when I change files in the lake

This is intended. The files are locked so that nothing changes them by accident. Use quantlake delete or quantlake recollect instead. If you unlock the files with sudo chattr -i and change them anyway, quantlake verify reports the change and the server downloads those days again.

quantlake status says the server is not running

Check systemctl status quantlake-server and journalctl -u quantlake-server. Targets and requests that you register in the meantime are kept, and the server processes them when it starts again.

A target shows as not available

Your plan may not include that exchange, symbol or date range, or the symbol may be written wrongly. Check what you can download:

quantlake available --exchange binance-futures --data-type trades --symbol BTCUSDT --refresh --wait
  • Tardis.dev: grouped symbols, such as PERPETUALS, are not supported.
  • Databento: check how the symbol is written (see Exchanges and symbols). A single contract, such as ESZ6, is only available for the days on which it was listed.

Some days failed to download

quantlake status lists each failure and when the server will try again:

KindMeaningNext try
transientNetwork or provider server errorWith backoff, waiting at most 6 hours
not_publishedThe provider has not published the day yetAfter 1 hour
over_budgetThe Databento day costs more than the budget left this monthAfter 1 day. See Paying for Databento data
forbiddenYour API key does not include this dataAfter 1 day
not_foundThe provider has no data for this dayAfter 1 day
invalidThe request was not validAfter 1 day

Run quantlake recollect for the range to retry right away. With Tardis.dev, a 403 error usually means that the same API key was used from another IP address. It clears after about 15 minutes.

Downloads stopped

Free disk space has probably fallen below the threshold. quantlake status shows the message and the free space. Free up space, or lower the threshold:

quantlake config set server.min_free_gb 10