Hyperliquid Funding Rate Carry Bot

The bot scans Hyperliquid perp markets for unusually large predicted funding rates. If funding is strongly positive, it opens a short so the position receives funding. If funding is strongly negative, it opens a long for the same reason.

That is useful, but it is not true arbitrage. There is no hedge leg. The bot takes outright directional perp exposure while it waits to collect funding, so price movement can easily dominate the funding income.

The strategy is best understood as directional funding carry: a way to monetize extreme positioning when you are willing to wear the underlying market risk.

Every bot-opened position is tracked in process memory with its open time plus the next top-of-hour funding settlement. The bot will hold that position until that next settlement before closing it just because funding normalized, which reduces trivial churn around noisy snapshots.

You can bound exposure with `--max-positions` and `--max-hold-hours`. If a market still looks attractive but the bot is already at its cap, it leaves the extra opportunity alone instead of stacking risk indefinitely.

The bot also continues to leave manual positions alone. It only auto-manages positions it opened itself during the current process lifetime, and if you manually change the side or size it stops managing that symbol.

`--threshold` is measured in funding percent per hour. `--interval` is the polling cadence in seconds. `--max-positions` controls breadth and `--max-hold-hours` is a hard hold cap for bot-opened positions.

`--size` is asset-unit size, reused across every market the bot touches. That means a single value like `0.01` behaves very differently on BTC than it does on a low-priced alt. If you want tighter per-market control, you would still need to extend the bot.

Scan-only mode is still available when you want to inspect opportunities without placing any trades.

The main risk is straightforward: the bot may receive funding and still lose money on price. A position earning funding into a strong trend can still perform badly if the market keeps moving against it.

This implementation also does not persist its bot-managed settlement-tracking state across restarts. If you restart the process, previously opened positions are no longer treated as bot-managed positions for minimum-hold logic.

So the value here is transparency and a cleaner starting point, not a claim that this is finished institutional funding arbitrage infrastructure.