Hyperliquid Perp Signals

Signal scanner for the Hyperliquid perpetual futures DEX. Funding rates, open interest shifts, liquidation events, and cross-venue basis setups — all in a single CLI.

When to use

• User wants perp alpha on Hyperliquid
• Hunting funding-rate arb between Hyperliquid and Binance/Bybit
• Watching for liquidation cascades on-chain
• Tracking crowded long/short positioning via OI divergence
• Surfacing squeeze setups before they happen

Commands

python3 scripts/hl_signals.py funding           # All perps, current funding rate
python3 scripts/hl_signals.py funding SOL       # Specific coin
python3 scripts/hl_signals.py oi                # Open interest ranked by 24h change
python3 scripts/hl_signals.py liqs              # Recent liquidation events
python3 scripts/hl_signals.py basis BTC         # HL vs Binance funding basis
python3 scripts/hl_signals.py squeeze ETH       # Short squeeze risk score

Output

JSON with: coin, mark_price, oracle_price, funding_rate (1h, annualized %), open_interest_usd, oi_change_24h_pct, next_funding_eta_seconds, signal (LONG_BIAS, SHORT_BIAS, NEUTRAL, SQUEEZE_SETUP, CASCADE_RISK), and a confidence score 0-100.

Environment

• HL_API_URL - Hyperliquid info endpoint (default: https://api.hyperliquid.xyz/info)
• HL_BINANCE_FUNDING_COMPARE - whether to include Binance basis (default: true)
• Works with mock data when API is unreachable; production uses Hyperliquid's public info endpoint