Neko Futures Trader 🐱📈#

Quick Install (For New Agent)#

bash

# 1. Navigate to workspace
cd /root/.openclaw/workspace/neko-futures-trader

# 2. Check files exist
ls -la *.py *.md

# 3. Verify .env exists
cat .env | head -3

# 4. Start scanner
nohup python3 scanner-v8.py &

# 5. Start price monitor
nohup python3 price-monitor.py &

# 6. Check status
python3 position_command.py

Auto Features (All Running)#

FeatureStatusDescription🔍 Auto Entry✅ ONScanner runs every 5 min⏱️ Auto TP/SL✅ ONPrice monitor every 1 sec🧹 Auto Cache✅ ONCleans 24h old entries on startup🛡 Auto Breakeven✅ ONSL → Entry at +5%🎯 Auto Trailing✅ ONTP trails at +10%🚫 Auto Delisting✅ ONBlocks bad tokens🔄 Auto Recovery✅ ONSelf-heals from errors📱 Auto Notify✅ ONTelegram alerts

Configuration (config.py)#

python

# === TRADING ===
MAX_POSITIONS = 7
AUTO_FILL_EMPTY_SLOTS = True
ENTRY_PERCENT = 6%
LEVERAGE = 10

# === RISK ===
MIN_PROFIT_BREAKEVEN = 5.0      # SL → Entry at +5%
MIN_PROFIT_TRAILING_TP = 10.0   # Trail at +10%

# === MULTI-TP (1:2 R/R) ===
TP1_PERCENT = 10.0   # Close 40% @ +10%
TP2_PERCENT = 15.0   # Close 30% @ +15%
TP3_PERCENT = 20.0   # Close 30% @ +20%

# === DYNAMIC ATR ===
ATR_MULTIPLIER_SL_HIGH = 2.0    # High vol: SL 2×ATR
ATR_MULTIPLIER_TP_HIGH = 4.0    # High vol: TP 4×ATR
ATR_MULTIPLIER_SL_NORMAL = 1.5  # Normal: SL 1.5×ATR
ATR_MULTIPLIER_TP_NORMAL = 3.0  # Normal: TP 3×ATR
ATR_MULTIPLIER_SL_LOW = 1.0     # Low vol: SL 1×ATR
ATR_MULTIPLIER_TP_LOW = 2.5     # Low vol: TP 2.5×ATR

# === MONITOR ===
CHECK_INTERVAL = 1  # seconds

Signal Indicators (v1.0.36)#

#IndicatorConditionScore1Volume Spike>3x avg+22Price Change>10%+231H Change>3%+14BreakoutHH/HL broken+25BreakdownLH/LL broken+26OI Increase>20%+27Weekly Change>20%+38Pocket PivotYes+29RSI<30 or >70+110MACD CrossHistogram+111BollingerBand touch+112VWAP CrossPrice cross+113Volume 5xExtra spike+214DCR>20%+1

Minimum Score: 3 to trigger signal

File Structure#

text

neko-futures-trader/
├── scanner-v8.py          # Main scanner (auto entry)
├── price-monitor.py       # TP/SP executor (auto close)
├── config.py             # All settings
├── advanced_analysis.py   # RSI, MACD, etc.
├── error_handling.py     # Circuit breaker, rate limiter
├── delisting_monitor.py   # Auto block delisted
├── position_command.py    # /position command
├── .env                  # API keys (SECRET)
├── .positions_sl_tp.json # Position cache
├── .recently_closed      # Closed cache (24h)
├── .posted_signals       # Posted cache
├── README.md             # Documentation
└── SKILL.md              # This file

Commands#

Start Scanner#

bash

cd /root/.openclaw/workspace/neko-futures-trader
nohup python3 scanner-v8.py > scanner.log 2>&1 &

Start Price Monitor#

bash

cd /root/.openclaw/workspace/neko-futures-trader
nohup python3 price-monitor.py > pm.log 2>&1 &

Check Positions#

bash

python3 position_command.py

Check Running#

bash

pgrep -f scanner-v8 && echo "Scanner OK"
pgrep -f price-monitor && echo "Monitor OK"

Current Status (2026-03-19)#

• 💰 Balance: ~$392
• 📊 Positions: 2/7 (KAVA, ARB)
• 🔍 Scanner: Running
• ⏱️ Monitor: Running
• 📱 Telegram: Connected

Safety Features#

1. Cache Auto-Cleanup: Removes entries >24h old
2. Recently Closed: Skips re-entry for 24h
3. Delisting Monitor: Auto-blocks bad tokens
4. Error Handling: Circuit breaker, rate limiter
5. Recovery: Auto-restart on failure

---

Built by Neko Sentinel 🐱🛡️