🚀 Aster DEX Liquidation Hunter Bot

⚠️ OPEN BETA WARNING - Please trade with caution! This software is in open beta.

A smart trading bot that monitors and trades liquidation events on Aster DEX. Features automated trading, risk management, and a beautiful web dashboard.

💝 Support This Free Bot

This bot is 100% FREE! If you find it useful, please support development by creating your Aster DEX account with our referral link:

👉 Create Aster DEX Account (Support Development)

Using our referral link costs you nothing extra but helps fund continued development. Thank you!

🎯 What Makes This Bot Special

📈 Real-time Liquidation Hunting - Monitors and instantly trades liquidation events
💰 Smart Position Management - Automatic stop-loss and take-profit on every trade
🧪 Paper Trading Mode - Test strategies safely with simulated trades
🎨 Beautiful Web Dashboard - Monitor everything from a clean, modern UI
⚡ One-Click Setup - Get running in under 2 minutes
🔄 Auto-Reconnection - Never miss a trade due to connection issues
📊 VWAP Protection - Avoid bad entries with volume-weighted analysis
🛡️ Risk Controls - Position limits and leverage management built-in

🚀 Quick Start

📹 Video Setup Guide

🎥 Watch Complete Setup Tutorial - Follow along with this step-by-step video guide!

Prerequisites

Before installing the bot, make sure you have the following installed on your system:

Node.js v20.0.0 or higher (Required)
- Download from: https://nodejs.org/
- Verify installation: node --version (should show v20.x.x or higher)
- Includes npm (Node Package Manager) which is required for installation
Git (Required for cloning the repository)
- Windows: Download from https://git-scm.com/download/win
- macOS: Install via Homebrew brew install git or from https://git-scm.com/download/mac
- Linux: sudo apt-get install git (Ubuntu/Debian) or sudo yum install git (RHEL/CentOS)
- Verify installation: git --version
Aster DEX Account (Required for live trading)
- Create account at: https://www.asterdex.com/en/referral/3TixB2
- Generate API keys for bot access (see Configuration section)

Installation

# 1. Clone the repository
git clone https://github.com/CryptoGnome/aster_lick_hunter_node.git
cd aster_lick_hunter_node

# 2. Run setup wizard
npm run setup

# 3. Start the bot
npm run dev

Configuration

Get API Keys: Sign in to Aster DEX → Settings → API Management
Configure Bot: Open http://localhost:3000/config
Add API Keys: Paste your keys in the web UI
Start Trading: Toggle paper mode off when ready

📊 Web Dashboard

Access at http://localhost:3000

Dashboard - Monitor positions and P&L
Config - Adjust all settings via UI
History - View past trades

⚙️ Commands

npm run dev        # Run bot + dashboard
npm run start      # Production mode
npm run bot        # Run bot only
npm test           # Run tests

🔄 Updating the Bot

When pulling updates from the repository:

# 1. Pull latest changes
git pull

# 2. Install any new dependencies
npm install

# 3. Build the project
npm run build

# 4. Run the bot
npm run dev

Note: The npm install step is crucial as dependencies may have changed between versions.

🧪 Testing Beta Features (Dev Branch)

Want to try the latest features before they're officially released? You can switch to the dev branch to access beta features and improvements.

What is the Dev Branch?

main branch: Stable, production-ready releases only
dev branch: Latest features, improvements, and bug fixes (beta testing)

The dev branch contains cutting-edge features that are being tested before official release. While generally stable, it may occasionally have minor issues.

Switching to Dev Branch

# 1. Make sure you have the latest code
git fetch origin

# 2. Switch to the dev branch
git checkout dev

# 3. Pull the latest dev changes
git pull origin dev

# 4. Install any new dependencies
npm install

# 5. Build and run
npm run build
npm run dev

Switching Back to Stable (Main)

If you encounter issues or want to return to the stable release:

# 1. Switch back to main branch
git checkout main

# 2. Pull latest stable release
git pull origin main

# 3. Reinstall dependencies
npm install

# 4. Build and run
npm run build
npm run dev

Keeping Dev Branch Updated

When on the dev branch, regularly pull updates to get the latest features:

# Quick update command
git pull origin dev && npm install && npm run build

Reporting Beta Issues

Found a bug in the dev branch? Help us improve!

Check if you're on dev: git branch --show-current
Create an Issue with:
- Branch name (dev)
- Steps to reproduce
- Expected vs actual behavior
- Console logs/screenshots

Note: Always start with paper mode when testing new beta features!

🛡️ Safety Features

Paper mode for testing
Automatic stop-loss/take-profit
Position size limits
WebSocket auto-reconnection

🌐 Remote Access Configuration

The bot supports remote access, allowing you to monitor and control it from any device on your network.

Enable Remote WebSocket Access

Via Web UI (Recommended):
- Navigate to http://localhost:3000/config
- Go to "Server Settings" section
- Toggle "Enable Remote WebSocket Access"
- Save configuration
- Access from remote device: http://your_server_ip:3000
Via Environment Variable (Advanced):
- Copy .env.example to .env.local
- Set NEXT_PUBLIC_WS_HOST=your_server_ip
- Restart the application

Remote Access Options

Method	Description	Use Case
Auto-detect	Automatically uses browser's hostname	Default - works for most setups
Config Host	Set specific host in config UI	When using specific hostname/domain
Environment Variable	Override via `NEXT_PUBLIC_WS_HOST`	Docker/cloud deployments

Note: When accessing remotely, ensure port 8080 (WebSocket) is accessible on your network.

📱 Configuration Options

All settings available in the web UI:

Setting	Description	Default
Paper Mode	Test without real money	ON
Leverage	Position multiplier	10x
Stop Loss	Max loss per trade	20%
Take Profit	Target profit	1%
Volume Filter	Min liquidation size	$1000

🚨 Important Notes

Always start in paper mode - Test your settings first
API Security - Never share your API keys
Risk Warning - Crypto trading involves significant risk

🤝 Need Help or Want to Contribute?

🐛 Found a Bug?

Create an Issue - We'll fix it ASAP!

💡 Have an Idea?

Request a Feature - We love new ideas!

🔧 Want to Contribute?

Fork the repo
Create your feature branch (git checkout -b feature/YourFeature)
Commit changes (git commit -m 'Add YourFeature')
Push (git push origin feature/YourFeature)
Open a Pull Request

💬 Join the Community

Discord Server - Get help, share strategies, and chat with other traders!

📄 License

MIT License - Free to use and modify

⚠️ Disclaimer

IMPORTANT RISK WARNING: Trading cryptocurrency carries substantial risk of loss. This bot is provided for educational and research purposes only.

No Warranty: This is open source software provided "as is" without warranty of any kind. There may be bugs, errors, or unexpected behavior that could result in financial losses.

Developer Liability: The developers of this open source project are in no way responsible for any financial losses, damages, or other consequences that may result from using this software. By using this bot, you acknowledge and accept full responsibility for all trading decisions and outcomes.

Use at Your Own Risk: Only trade with funds you can afford to lose completely. Always do your own research, test thoroughly in paper mode, and trade responsibly. Never risk more than you can afford to lose.

Support Development: Create Aster DEX Account

Name		Name	Last commit message	Last commit date
Latest commit History 316 Commits
.github/workflows		.github/workflows
docs		docs
public		public
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
README.md		README.md
WIKI.md		WIKI.md
components.json		components.json
config.default.json		config.default.json
eslint.config.mjs		eslint.config.mjs
jest.config.js		jest.config.js
next.config.ts		next.config.ts
optimize-config.js		optimize-config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
symbols.json		symbols.json
tsconfig.json		tsconfig.json

CryptoGnome/aster_lick_hunter_node

Folders and files

Latest commit

History

Repository files navigation