Neko Futures Trader

Automated Binance Futures trading scanner with runner detection and price monitor. Features: - Runner detection (volume spike + momentum + breakout) - Real c...

MIT-0 · Free to use, modify, and redistribute. No attribution required.
0 · 27 · 0 current installs · 0 all-time installs
byluke@lukmanc405
MIT-0
Security Scan
VirusTotalVirusTotal
Pending
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
The name/description (Binance Futures scanner, Telegram alerts, Brave news) matches the included code: scanner, price-monitor, and position-monitor call Binance APIs, send Telegram messages, and reference a Brave API key. Required binaries (python3) and env vars (BINANCE_API_KEY, BINANCE_SECRET, TELEGRAM_* , BRAVE_API_KEY) are what you would expect for this functionality.
Instruction Scope
Runtime instructions and SKILL.md focus on cloning, creating a .env, and running the Python scripts (or a background restart loop). The code reads the .env and uses it; position-monitor uses os.system to trigger scanner-v8.py (quick_scan). All referenced files/paths are within the workspace. Minor note: SKILL.md/README suggest cloning from GitHub even though the registry 'Source' is unknown — this is informational but not necessarily malicious.
Install Mechanism
No install spec downloads arbitrary third-party binaries or archives. This is primarily an instruction+code bundle requiring installing Python packages (requests). No suspicious remote-install URLs or extract actions are present.
Credentials
Requested environment variables are relevant to the stated purpose. Two small inconsistencies: (1) README says Brave Search is optional but BRAVE_API_KEY is listed as required in metadata; (2) SKILL.md suggests 'pip install requests hmac hashlib' though hmac/hashlib are stdlib. Aside from these documentation mismatches, requested credentials are proportional to the bot's behavior (trading + alerts + news).
Persistence & Privilege
The skill's metadata includes a startup/background command that runs the scanner loop under /root/.openclaw/workspace, which would create a persistent background process if executed. However, the skill is not 'always: true' and does not request elevated system-wide privileges; persistence is limited to its own workspace/log files. Consider whether you want a service that auto-restarts and runs continuously.
Assessment
This skill appears to be what it claims: an automated Binance Futures scanner that can auto-execute trades and post Telegram alerts. Things to consider before installing or running it: - Security of API keys: the bot requires BINANCE_API_KEY and BINANCE_SECRET with trading permissions to auto-execute orders. Prefer creating keys with restricted permissions/whitelisted IPs and test on Binance testnet first. Do NOT use exchange keys with unrestricted withdrawal permissions. - Review and run locally first: inspect scanner-v8.py / price-monitor.py to confirm behavior and understand how orders are placed (market orders, stop orders, leverage). Run in a non-production/test account until you trust it. - Telegram scope: TELEGRAM_BOT_TOKEN and TELEGRAM_CHANNEL are only used for sending messages; ensure the bot is only given needed permissions. - Brave API key appears optional in the README but is marked required in metadata — you can omit Brave if you don't want news features. - Persistence: the startup command will run a background loop and write logs/state files under the workspace; consider running under a dedicated user (not root) and monitor the process. - Author/source: the README references a GitHub repo (lukmanc405) but registry 'Source' is unknown. If provenance matters, verify the upstream repository and recent commits. If you decide to proceed, restrict API key scopes, test thoroughly, and keep backups of keys/configs.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.9
Download zip
binancevk97cxxw1rc0rf9m79yeb6r5329831pe4cryptovk97cxxw1rc0rf9m79yeb6r5329831pe4futuresvk97cxxw1rc0rf9m79yeb6r5329831pe4latestvk97es9e1676d9jp55d88pdfr1h832pmxtradingvk97cxxw1rc0rf9m79yeb6r5329831pe4

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

🐱📈 Clawdis
Binspython3
EnvBINANCE_API_KEY, BINANCE_SECRET, TELEGRAM_BOT_TOKEN, TELEGRAM_CHANNEL, BRAVE_API_KEY

SKILL.md

Neko Futures Trader 🐱📈

Complete Binance Futures automated trading system.

Quick Setup

# 1. Clone
git clone https://github.com/lukmanc405/neko-futures-trader.git

# 2. Install
pip install requests hmac hashlib

# 3. Configure
cp .env.example .env
nano .env

# 4. Run
nohup python3 scanner-v8.py &
nohup python3 price-monitor.py &

Environment Variables

Create .env file:

BINANCE_API_KEY=your_binance_api_key
BINANCE_SECRET=your_binance_secret
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_CHANNEL=your_channel_id
BRAVE_API_KEY=your_brave_api_key

Scripts

scanner-v8.py

Finds trading signals:

  • Scans 500+ USDT pairs
  • Runner detection (volume + momentum + breakout)
  • Real news via Brave Search
  • Posts to Telegram
  • Auto-executes trades
nohup python3 scanner-v8.py > scanner.log 2>&1 &

price-monitor.py

Monitors positions:

  • Checks every 60 seconds
  • Auto-closes when SL/TP hit
  • Fibonacci+ATR based levels
  • Emoji alerts to Telegram
nohup python3 price-monitor.py > price-monitor.log 2>&1 &

Fibonacci+ATR SL/TP

LevelFormula
SLEntry - 1.5×ATR
TP1Entry + 3×ATR (Fib 1.272)
TP2Entry + 4.5×ATR (Fib 1.618)

Alert Templates

Signal Alert

🟢 LONG SIGNAL 🟢

📈 BTCUSDT TECHNICAL ANALYSIS 📊
📊 Chart: https://www.tradingview.com/chart/?symbol=BINANCE:BTCUSDT

📐 MULTI-TF CONFIRMATION:
• Trend 1H: BULLISH
• Structure: BREAKOUT
📊 24h Change: +5.2%

📐 INDICATORS:
• RSI (14): 65.3
• EMA 21: 71234.56
• EMA 50: 70890.12
• ATR: 1234.56

🔊 VOLUME: Volume Spike (2.5x)

📊 STRUCTURE:
• Support: 70000.00
• Resistance: 72000.00

🎯 RUNNER METRICS:
• 1H Momentum: +3.2%
• Volume Spike: 2.5x
• Breakout: ✅ Yes
• Score: 7/10 🚀

💡 INSIGHT: LONG | BREAKOUT | RSI: 65.3
🎯 Entry: $71000.00
📈 TP: $74500.00
🛡 SL: $68000.00
⏰ Timeframe: 1H

📰 Bitcoin surges past $71K as...

✅ ORDER EXECUTED: LONG
📋 Order ID: 123456789 | Status: NEW

Profit Alert

🎉💰 PROFIT TAKEN! 💰🎉

🟢 TIAUSDT LONG
📈 +5.02% ($5.02)
Entry: $0.364600 → Exit: $0.382940
Target: $0.390323 (TP1) 🎯

#TakeProfit #Winning #Crypto

Stop Loss Alert

❌ STOP HIT

🔴 AXSUSDT LONG
📈 -3.12% (-$3.50)
Entry: $1.237000 → Exit: $1.199000
Target: $1.199890 (SL) 🎯

#StopLoss #Trading #Crypto

Configuration

scanner-v8.py

LEVERAGE = 10           # 10x leverage
MAX_POSITIONS = 8       # Max open positions
ENTRY_PERCENT = 5       # % of margin per trade
MIN_GAIN = 0.5          # Min 24h change %

price-monitor.py

CHECK_INTERVAL = 60      # Seconds between checks

Runner Detection

CriteriaWeight
Volume Spike 3x++2
Volume Spike 2x++1
24h Change 10%++2
24h Change 5%++1
1H Momentum 3%++1
Breakout+2

Minimum: 3/10 to trigger

Files

  • scanner-v8.py - Main scanner
  • price-monitor.py - Auto-close monitor
  • .env.example - Template
  • README.md - Full docs
  • SKILL.md - This file

Safety

⚠️ Trading futures involves substantial risk. Only trade with capital you can afford to lose. Monitor positions regularly.


Skill by Neko Sentinel 🐱🛡️

Files

7 total
Select a file
Select a file to preview.

Comments

Loading comments…