A delta-neutral funding rate keeper powered by the Kodiak Signal API. Intelligence comes from the API. Execution runs locally with your wallet.
┌─────────────────────────┐ ┌──────────────────────┐
│ Kodiak Signal API │ │ Your Machine │
│ (paid, $99/mo Pro) │ │ │
│ │ │ This keeper │
│ regime: "defensive" │────>│ (open source) │
│ deployment: 30% │ │ │ │
│ leverage: 0.5x │ │ ▼ │
│ signals: [cascade] │ │ Your HL wallet │
│ │ │ (your keys, your $) │
└─────────────────────────┘ └──────────────────────┘
You provide: API key + wallet private key. Fabrknt provides: Real-time regime decisions powered by 6D signal detection, liquidation tracking, and cross-venue intelligence. Fabrknt never touches your funds.
# Clone
git clone https://github.com/fabrknt/keeper-hl-template.git
cd keeper-hl-template
# Install
pip install -r requirements.txt
# Configure
cp .env.example .env
# Edit .env:
# FABRKNT_API_KEY=fbrk_your_key (get at https://flow.fabrknt.com/dashboard)
# HL_PRIVATE_KEY=0x_your_key (YOUR wallet)
# HL_NETWORK=testnet (start on testnet!)
# Run
python -m src.main| Endpoint | What It Returns |
|---|---|
/v1/regime |
Deployment %, leverage cap, rebalance mode (the main decision) |
/v1/signals |
4D anomaly detection (OI shift, liquidation cascade, funding vol, spread) |
/v1/liquidations |
Real-time HL liquidation tracking (zero-hash trades) |
/v1/cross-venue |
HL vs Binance/Bybit funding comparison |
/v1/funding |
Market rankings by funding rate |
/v1/preposition |
Pre-positioning advisory before hourly funding settlement |
- Position execution (spot buy + perp short)
- Health monitoring (margin ratio, drawdown)
- Emergency exits (close all if drawdown exceeds threshold)
- Order management
Edit src/config.py for execution parameters:
| Parameter | Default | Description |
|---|---|---|
max_drawdown_pct |
3% | Reduce positions above this |
severe_drawdown_pct |
5% | Close all above this |
max_slippage_pct |
0.5% | Reject trades with more slippage |
rebalance_interval_s |
4h | How often to rebalance |
allowed_markets |
["HYPE"] | Which markets to trade |
fallback_deployment_pct |
50% | Deployment if API is down |
If the signal API is unreachable for >10 minutes:
- Keeper enters fallback mode
- Deployment reduced to 50%
- No new positions opened
- Existing positions maintained with local health monitoring
This keeper template is free and open source. The signal API requires a Pro subscription ($99/mo) at flow.fabrknt.com/dashboard.
MIT