Skip to content

data#

Manage the local Hyperliquid data cache. Every other command reads from it.

Subcommands#

Command What it does
pull <asset> Pull candle history. Resumes from the last cached candle.
pull-funding <asset> Pull funding-rate history.
pull-fills <wallet> Pull per-wallet fill history.
pull-vault <vault> Reserved for Phase 5+ vault trade ingestion.
ls List cached datasets with row counts and date ranges.
info Cache directory, total size, file count, last sync.
clear Selective clear by --asset and/or --kind.

hlr data pull <asset>#

hlr data pull BTC --interval 1h --since 2024-01-01 --until 2026-05-01

Options:

  • --interval — one of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M. Default 1h.
  • --since — UTC date or YYYY-MM-DDTHH:MM:SS. Default 2023-01-01.
  • --until — same format. Default now.

Re-running is incremental. The cache resumes from the last cached candle automatically.

hlr data pull-funding <asset>#

hlr data pull-funding BTC --since 2024-01-01

Same --since / --until semantics. HL emits funding every hour; expect ~24 rows per day per asset.

hlr data pull-fills <wallet>#

hlr data pull-fills 0xabc... --since 2024-01-01

Wallet must be a 42-character hex address. The cache stores all of a wallet's fills, partitioned by quarter.

hlr data ls#

$ hlr data ls
KIND     ENTITY         INTERVAL  ROWS    SIZE     SINCE       UNTIL       UPDATED
candles  BTC            1h        15,432  2.3 MB   2024-01-01  2026-05-01  2026-05-19 14:32
funding  BTC            —         18,789  421 KB   2024-01-01  2026-05-01  2026-05-19 14:33
fills    0xabc1…d4f2    —         247     38 KB    2024-03-12  2026-05-18  2026-05-19 14:35

hlr data info#

Filesystem stats over the cache root.

hlr data clear#

hlr data clear --asset BTC
hlr data clear --kind funding
hlr data clear --asset BTC --kind candles --yes  # skip confirmation

Requires at least one of --asset or --kind. Clearing the entire cache must be explicit (combine both flags or run each kind).

JSON mode#

hlr --json data ls

Emits a list of cache entry objects to stdout. Pipe into jq or a script.