Skip to content

wallet#

Inspect a wallet's current state, build a wrapped report, list fills, or sum funding.

Subcommands#

Command What it does
inspect <wallet> Live account state: equity, margin used, open positions.
wrapped <wallet> Full behavioral report. Headline artifact of hl-research.
fills <wallet> List recent fills, live from the API.
funding <wallet> Per-asset funding paid, earned, net.

hlr wallet inspect <wallet>#

Single live call to HL's clearinghouseState. Shows:

  • Account value
  • Withdrawable cash
  • Margin used
  • Notional exposure
  • All open positions (coin, side, size, entry, notional, leverage, uPnL, liquidation price)

hlr wallet wrapped <wallet>#

hlr data pull-fills 0xabc... --since 2024-01-01
hlr wallet wrapped 0xabc... --since 2024-01-01 --out wrapped.html

Requires cached fills. The HTML output is fully self-contained (plotly bundle inlined, no CDN). Sections:

  1. Header with wallet, period, equity
  2. Summary card: realized PnL, funding net, win rate, trade count
  3. Behavior cluster classification with explanation
  4. PnL by asset with bar chart and table
  5. Hour-of-day trade count chart
  6. Hold-time distribution
  7. Funding ledger
  8. Counterfactual versus holding entry through period end
  9. Top 20 wins, top 20 losses

Behavior labels (rules-based, evaluated in order):

Label Criterion
revenge_trader >40% of fills opened within 10 minutes of a closing loss
funding_farmer Total funding earned > realized PnL AND median hold > 8h
leverage_addict Average notional / account equity > 10
scalper Median round-trip hold < 5 minutes
hold_and_pray Median round-trip hold > 7 days
swing_trader Median round-trip hold between 1 hour and 24 hours
chad Win rate > 65% AND profit factor > 2.0 AND >= 20 trades
balanced Default fallback

hlr wallet fills <wallet>#

hlr wallet fills 0xabc... --asset BTC --limit 100
hlr wallet fills 0xabc... --csv > fills.csv

Live fetch via userFills. Use --csv for piping into scripts.

hlr wallet funding <wallet>#

hlr wallet funding 0xabc... --since 2024-01-01

Per-asset paid/earned/net plus a totals row. Live fetch from userFunding.

JSON mode#

All four commands respect --json. The wallet wrapped --json payload includes the full WrappedReport (PnL by asset, hour-of-day, hold-time distribution, behavior label and reason, counterfactual, top fills) as a single JSON document.