Aster Trading Bot

An automated cryptocurrency trading bot for AsterDEX futures trading platform. The bot implements sophisticated trading strategies with comprehensive risk management, position tracking, and real-time market analysis.

My indicators have demonstrated reliable performance, generating an estimated 2.3%–7.4% profit during 95 hours of testing. To support the developer, contributions in USDT (Sol) can be sent to: 4F5oYCAWYnUxr6QWudXjn8wEeDSCsaQJhUknZNe9UF18

Test Results

The bot has been extensively tested with real trading data. Below are screenshots and a recording showing the bot's performance on the AsterDEX platform.

Performance Screenshots

Trade history showing profitable sell transactions

Additional trade history entries with realized profits

More trade history showing consistent profitable trades

Trade history with various buy and sell transactions

Detailed trade history showing price movements and profits

Trade history displaying realized profits in USDT

Additional trade history entries with profit/loss details

Performance Recording

Video recording of the bot's trading activity and performance

Features

Dual Strategy Support:
- Watermellon Strategy: EMA-based trend following with RSI confirmation
- Peach Hybrid Strategy: Dual-system approach combining trend bias (V1) and momentum surge (V2)
Advanced Risk Management:
- Configurable position sizing and leverage limits
- Stop-loss and take-profit mechanisms
- Emergency stop-loss protection
- Trailing stop-loss for profit protection
- Maximum flips per hour limit
- Consecutive loss protection
Real-time Market Analysis:
- ADX for market regime detection (trending vs ranging)
- ATR for dynamic stop-loss placement
- RSI for momentum confirmation
- Support/resistance level tracking
Position Management:
- Automatic position reconciliation with exchange
- State persistence across restarts
- Order tracking and confirmation
- Flip prevention (minimum hold time)
Comprehensive Logging:
- Trade entry/exit logging
- Signal analysis and filtering
- Daily CSV and JSON trade logs
- Real-time console output

Prerequisites

Node.js 18+ and npm
AsterDEX account with API credentials
TypeScript knowledge (for development)

Installation

Clone the repository:

git clone <repository-url>
cd aster-bot

Install dependencies:

npm install

Copy the example environment file:

cp env.example .env.local

Configure your environment variables in .env.local (see Configuration section)

Configuration

Required Environment Variables

ASTER_RPC_URL=https://fapi.asterdex.com
ASTER_WS_URL=wss://fstream.asterdex.com/ws
ASTER_API_KEY=your_api_key
ASTER_API_SECRET=your_api_secret
WALLET_PRIVATE_KEY=your_private_key
PAIR_SYMBOL=ASTERUSDT-PERP
MODE=dry-run

Risk Management Settings

MAX_POSITION_USDT=10000
MAX_LEVERAGE=5
MAX_FLIPS_PER_HOUR=12
STOP_LOSS_PCT=0
TAKE_PROFIT_PCT=0
USE_STOP_LOSS=false
EMERGENCY_STOP_LOSS_PCT=2.0
MAX_POSITIONS=1
REQUIRE_TRENDING_MARKET=true
ADX_THRESHOLD=25

Note: MAX_LEVERAGE must be one of the supported values: 5, 10, 15, or 50. AsterDEX only accepts these specific leverage multipliers.

Strategy Selection

Set STRATEGY_TYPE to either:

watermellon: EMA-based trend following strategy
peach-hybrid: Dual-system hybrid strategy (default)

Strategy Parameters

Watermellon Strategy

EMA_FAST=8
EMA_MID=21
EMA_SLOW=48
RSI_LENGTH=14
RSI_MIN_LONG=42
RSI_MAX_SHORT=58

Peach Hybrid Strategy

V1 System (Trend/Bias):

PEACH_V1_EMA_FAST=8
PEACH_V1_EMA_MID=21
PEACH_V1_EMA_SLOW=48
PEACH_V1_EMA_MICRO_FAST=5
PEACH_V1_EMA_MICRO_SLOW=13
PEACH_V1_RSI_LENGTH=14
PEACH_V1_RSI_MIN_LONG=42.0
PEACH_V1_RSI_MAX_SHORT=58.0
PEACH_V1_MIN_BARS_BETWEEN=1
PEACH_V1_MIN_MOVE_PCT=0.10

V2 System (Momentum Surge):

PEACH_V2_EMA_FAST=3
PEACH_V2_EMA_MID=8
PEACH_V2_EMA_SLOW=13
PEACH_V2_RSI_MOMENTUM_THRESHOLD=3.0
PEACH_V2_VOLUME_LOOKBACK=4
PEACH_V2_VOLUME_MULTIPLIER=1.5
PEACH_V2_EXIT_VOLUME_MULTIPLIER=1.2

Timeframe Configuration

VIRTUAL_TIMEFRAME_MS=30000

Usage

Running in Dry-Run Mode

Test the bot without executing real trades:

npm run bot

The bot will simulate trades and log all actions without placing actual orders.

Running in Live Mode

⚠️ WARNING: Live mode executes real trades with real money!

Set MODE=live in your .env.local
Review all risk settings carefully
Start with small position sizes
Run the bot:

npm run bot

The bot will display a 5-second warning before starting in live mode.

Strategies

Watermellon Strategy

A trend-following strategy that uses:

EMA Stack: Fast (8), Mid (21), and Slow (48) EMAs for trend detection
RSI Filter: Confirms signals with RSI thresholds
ADX Filter: Only trades in trending markets (ADX > threshold)
Signal Generation:
- Long: Bullish EMA stack + RSI > 42
- Short: Bearish EMA stack + RSI < 58

Peach Hybrid Strategy

A dual-system approach combining two complementary strategies:

V1 System (Trend/Bias)

Uses EMA stacks (main + micro) for trend bias detection
RSI confirmation for entry signals
Minimum bars between signals to prevent overtrading
Minimum price move requirement

V2 System (Momentum Surge)

Detects RSI momentum surges
Volume spike confirmation
Volume color analysis (bullish/bearish)
EMA direction alignment

Exit Conditions:

RSI flattening with volume drop
RSI reversal against position
Trailing stop-loss activation
Emergency stop-loss triggers

Risk Management Features

Position Limits

Max Position Size: Maximum USDT value per position
Max Leverage: Maximum leverage multiplier (must be 5, 10, 15, or 50)
Max Positions: Maximum concurrent positions (typically 1)

Flip Prevention

Max Flips Per Hour: Limits position reversals
Minimum Hold Time: Prevents instant position flips (5 minutes default)

Stop-Loss Protection

Emergency Stop-Loss: Hard stop at configured percentage (1% for Peach, 2% default)
Trailing Stop-Loss: Dynamic stop that follows price (0.3% for Peach)
Regular Stop-Loss: Configurable percentage-based stop

Market Regime Filtering

ADX Threshold: Only trades when market is trending (ADX > threshold)
Require Trending Market: Enables/disables market regime filter

Loss Protection

Consecutive Loss Limit: Stops trading after 2 consecutive losses
Risk/Reward Ratio: Requires minimum 2:1 R:R for Peach Hybrid signals

Project Structure

aster-bot/
├── src/
│   ├── bot/
│   │   └── index.ts              # Main bot entry point
│   ├── lib/
│   │   ├── bot/
│   │   │   └── botRunner.ts      # Core bot logic
│   │   ├── execution/
│   │   │   ├── dryRunExecutor.ts # Simulated execution
│   │   │   ├── liveExecutor.ts   # Real trade execution
│   │   │   └── orderTracker.ts   # Order confirmation tracking
│   │   ├── indicators/
│   │   │   ├── adx.ts            # ADX indicator
│   │   │   ├── atr.ts            # ATR indicator
│   │   │   ├── ema.ts            # EMA indicator
│   │   │   └── rsi.ts            # RSI indicator
│   │   ├── logging/
│   │   │   └── tradeLogger.ts    # Trade logging system
│   │   ├── rest/
│   │   │   └── restPoller.ts     # REST API polling
│   │   ├── security/
│   │   │   └── keyManager.ts     # API key protection
│   │   ├── state/
│   │   │   ├── positionState.ts  # Position state management
│   │   │   └── statePersistence.ts # State persistence
│   │   ├── config.ts             # Configuration loader
│   │   ├── peachHybridEngine.ts  # Peach Hybrid strategy
│   │   ├── watermellonEngine.ts  # Watermellon strategy
│   │   ├── tickStream.ts         # WebSocket tick stream
│   │   ├── types.ts              # TypeScript types
│   │   └── virtualBarBuilder.ts  # Virtual bar construction
│   └── app/                      # Next.js web interface
├── data/
│   └── trades/                   # Trade logs directory
├── env.example                    # Environment template
└── package.json

Development

Running Tests

The bot includes test files for development:

test-bot.ts: Basic bot testing
test-step-by-step.ts: Step-by-step execution testing

Building

npm run build

Linting

npm run lint

Logging

Trade logs are stored in data/trades/daily/:

CSV Format: trades-YYYY-MM-DD.csv - Spreadsheet-compatible trade data
JSON Format: trades-YYYY-MM-DD.json - Detailed trade information
Signals: signals-YYYY-MM-DD.json - All signals (taken and skipped)

Logs include:

Entry/exit prices and timestamps
P&L calculations
Indicator values at entry/exit
Market conditions
Risk parameters
Signal reasons and filters

State Persistence

The bot automatically saves state to data/bot-state.json:

Current position state
Last bar close time
State is loaded on restart (if less than 1 hour old)

Security

Key Protection: API keys are automatically redacted in logs
Safe Logging: KeyManager ensures sensitive data is never logged
Environment Variables: All credentials stored in .env.local (not committed)

Deployment

PM2 Deployment

The project includes ecosystem.config.js for PM2 process management:

pm2 start ecosystem.config.js
pm2 save
pm2 startup

Systemd Service

A systemd service file (watermellon-bot.service) is included for Linux deployments.

Monitoring

Monitor bot activity through:

Console output (real-time logs)
Trade log files (CSV/JSON)
PM2 logs: pm2 logs aster-bot
System logs (if using systemd)

Troubleshooting

Bot Not Starting

Check all required environment variables are set
Verify API credentials are correct
Ensure network connectivity to AsterDEX

No Trades Executing

Check market regime filters (ADX threshold)
Verify position size and leverage settings
Review signal logs to see why signals are skipped
Check balance is sufficient

Position Reconciliation Failures

Bot automatically freezes trading after 2 failures
Check REST API connectivity
Verify position on exchange matches bot state

Important Warnings

⚠️ Trading cryptocurrencies involves substantial risk of loss

Always test in dry-run mode first
Start with small position sizes
Never risk more than you can afford to lose
Monitor the bot regularly
Keep API keys secure
Review trade logs frequently
Understand the strategies before using them

License

This project is private and proprietary.

Support

For issues or questions:

Review the configuration settings
Check trade logs for signal analysis
Review console output for errors
Verify API credentials and connectivity

Telegram : https://t.me/MistKail

Disclaimer: This bot is provided as-is. Trading cryptocurrencies carries significant risk. Past performance does not guarantee future results. Use at your own risk.

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
data		data
public		public
src		src
test-data		test-data
.env		.env
.gitignore		.gitignore
README.md		README.md
Watermellon.pine		Watermellon.pine
bot-output.log		bot-output.log
ecosystem.config.js		ecosystem.config.js
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
test-bot.ts		test-bot.ts
test-step-by-step.ts		test-step-by-step.ts
tsconfig.json		tsconfig.json
watermellon-bot.service		watermellon-bot.service

Folders and files

Latest commit

History

Repository files navigation

Aster Trading Bot

Test Results

Performance Screenshots

Performance Recording

Features

Prerequisites

Installation

Configuration

Required Environment Variables

Risk Management Settings

Strategy Selection

Strategy Parameters

Watermellon Strategy

Peach Hybrid Strategy

Timeframe Configuration

Usage

Running in Dry-Run Mode

Running in Live Mode

Strategies

Watermellon Strategy

Peach Hybrid Strategy

V1 System (Trend/Bias)

V2 System (Momentum Surge)

Risk Management Features

Position Limits

Flip Prevention

Stop-Loss Protection

Market Regime Filtering

Loss Protection

Project Structure

Development

Running Tests

Building

Linting

Logging

State Persistence

Security

Deployment

PM2 Deployment

Systemd Service

Monitoring

Troubleshooting

Bot Not Starting

No Trades Executing

Position Reconciliation Failures

Important Warnings

License

Support

Telegram : https://t.me/MistKail

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages