Top Gainer Cooldown Signal User Guide

1️⃣ What Is the Top Gainer Signal?

The Top Gainer Signal is a smart entry system designed to trade explosive market moves — but safely.

Instead of buying during a pump (when risk is highest), it:

  1. Scans the entire exchange
  2. Finds the strongest gainers
  3. Waits for volatility to cool down
  4. Then enters the trade
  5. Hands control to your normal DCA + Volatility Gate + Grid DCA system

This makes entries more controlled and less emotional.

2️⃣ What Problem Does It Solve?

When coins pump 50%, 80%, or 100% quickly:

  • Buying immediately = high risk
  • Waiting too long = missed opportunity

This signal finds a balance: It waits for the post-pump cooldown before entering.

Think of it like:

“Let the crowd calm down… then enter.”

3️⃣ How It Works (Simple Explanation)

Step 1 – Scan the Market

The bot scans all exchange symbols and ranks them by percentage gain.

Example:

  • Coin A → +85%
  • Coin B → +72%
  • Coin C → +45%

Only the top gainers are considered.

Step 2 – Qualification Filter

A coin must exceed your configured minimum gain (example: 70%).

If min_gain_pct = 70:

  • +85% → qualifies
  • +72% → qualifies
  • +45% → ignored

Step 3 – Cooldown Observation (Volatility Gate)

Qualified coins are not traded immediately.

Instead, they enter an observation phase where the bot waits for:

  • Volatility to reduce
  • Price movement to calm
  • Or a controlled pullback

Only after a calm streak is detected does it enter the trade.

Step 4 – Trade Is Placed

When cooldown conditions are satisfied:

  • A signal is generated
  • A new position opens (Long or Short)
  • Your configured DCA + Grid DCA + Volatility Gate system takes over

From that point, everything behaves like your normal strategy.

4️⃣ Understanding the Configuration (User-Friendly)

Below is what each section means in plain English.

🔘 MASTER SWITCH

enabled: false
  • false → Feature is OFF
  • true → Feature is ACTIVE

Nothing runs unless this is enabled.

📊 Step 1 – Gainer Scan Settings

top_n

How many top coins to monitor.

Example:

top_n: 10

The bot checks the top 10 gainers only.

Increase this to monitor more coins.

lookback_candles

How far back to measure the gain.

Example:

lookback_candles: 24
kline_interval: "1h"

This means: 24 candles × 1 hour = 24-hour gain measurement.

If you change to:

lookback_candles: 12
kline_interval: "30m"

That becomes: 12 × 30 minutes = 6-hour measurement.

Shorter window = faster signals Longer window = stronger trend detection

📈 Step 2 – Qualification Filter

min_gain_pct

Minimum pump size required to qualify.

min_gain_pct: 70.0

Only coins that moved 70% or more are tracked.

Lower value → more signals Higher value → fewer but stronger signals

🌡 Step 3 – Cooldown (Volatility Gate)

This is where the intelligence happens.

The bot watches price behavior after the pump.

candles_to_analyze

How many recent candles are used to measure movement smoothness.

Lower = reacts faster Higher = smoother and safer

explosive_threshold_pct

If price is still moving strongly above this level, the bot continues waiting.

Lower = release earlier Higher = wait longer

neutral_threshold_pct

Defines what counts as “calm”.

If movement is below this %, it counts as one calm tick.

required_neutral_streak

How many calm readings are required before entry.

Example:

required_neutral_streak: 3

This means: 3 consecutive calm checks required.

Higher = safer entry Lower = faster entry

max_observation_minutes

Maximum waiting time before abandoning the setup.

Example:

max_observation_minutes: 120

If cooldown doesn’t happen in 2 hours → skip the trade.

🎯 Step 4 – Trade Direction

signal_direction: "long"

Options:

"long"

Buy after pump cools. Goal: catch second leg up.

"short"

Sell after pump exhausts. Goal: catch pullback or reversal.

⭐ Confidence Score

min_confidence: 65.0

The bot calculates a quality score (0–100).

Score is based on:

  • How big the original pump was
  • How well volatility cooled
  • How stable the calm period was

Only signals above this number are executed.

Raise it for higher quality entries.

5️⃣ Example Configurations

🛡 Conservative (Recommended for Live)

  • Wait for strong pumps
  • Wait for deeper cooldown
  • Fewer trades
min_gain_pct: 70
required_neutral_streak: 4
min_confidence: 70

Best for stable capital growth.

⚡ Aggressive

  • Faster entries
  • More trades
  • Higher risk
min_gain_pct: 50
required_neutral_streak: 2
min_confidence: 55

Better for high volatility environments.

📉 Short Strategy (Fade Pumps)

signal_direction: "short"
min_gain_pct: 80

Used when you prefer trading reversals.

6️⃣ When Should You Use This Signal?

This signal works best when:

  • Market has frequent explosive pumps
  • You want controlled entries
  • You want automation across all exchange symbols
  • You don’t want to manually chase trends

7️⃣ How It Works With DCA & Grid DCA

Important:

This signal only controls the initial entry.

After entry:

  • DCA logic runs normally
  • Grid DCA runs normally
  • Volatility Gate continues protecting positions
  • Smart SL / Smart TP behave exactly the same

No changes required to your existing setup.

8️⃣ When You May See No Signals

Common reasons:

  • enabled is false
  • min_gain_pct too high
  • Market is flat
  • Confidence threshold too strict
  • Observation timeout reached before cooldown

9️⃣ Best Practices

✔ Start in demo mode ✔ Review logs after a few hours ✔ Don’t set too aggressive cooldown settings ✔ Avoid extremely low gain thresholds in low volatility markets ✔ Combine with Smart Stop Loss for protection

🔟 Quick Strategy Comparison

Strategy Entry Timing Risk Level Best For
Momentum During pump High Breakout scalping
Top Gainer Cooldown After pump settles Medium Controlled continuation
Short Top Gainer After pump exhaustion Medium/High Reversal trading

✅ Final Summary

The Top Gainer Signal in MagicTradeBot v5.2:

• Scans all symbols • Detects explosive gainers • Waits for volatility cooldown • Enters intelligently • Hands control to DCA + Grid system

It is designed to make aggressive markets more controlled and structured.

If you'd like, I can now create:

  • 📘 A shorter marketing-style version for website
  • 🎥 A video script explanation
  • 🧠 A strategy comparison guide (Momentum vs Top Gainer vs AI)
  • 📊 A tuning cheat sheet table
  • 🌍 Or multilingual documentation version

Just tell me what you need next.

📎 Related Topics