Pump Guard

When auto-rebuy is running, Zephyr continuously fires buy attempts. That is exactly what you want on a coin that is trending up slowly, but on a coin that spikes 40% in a second and then crashes, it means you risk filling a buy at the very top of the pump.

Pump guard watches the price in real time and stops auto-rebuy when it detects a spike. When the price has jumped enough to look like a real pump rather than a quick bounce, auto-rebuy is switched off entirely and you decide when to turn it back on. A short notice in the position card tells you it was a pump that stopped it (rather than a manual stop).

It is off by default and only affects auto-rebuy: a manual Buy press is never affected.

What counts as a pump

A pump is when the price jumps by at least the threshold and stays there. A quick dip followed by a recovery to the same level does not count. This means normal volatility trading (buying the dips, riding the bounces) is not affected, only a sustained spike triggers the guard.

What happens when it fires

Auto-rebuy is turned off, just like pressing Stop yourself. If you are still holding tokens the bot falls back to Holding (so the take-profit target stays armed); otherwise it goes Idle. To resume buying you press W again. Pressing W is a deliberate override: it clears the guard's price history and starts fresh, so your re-arm sticks and is not immediately stopped by the same spike. The guard only kicks in again if a brand new pump develops after you re-arm.

When to use it

Pump guard is most useful on the Spam preset or any setup where you are firing buys very frequently on a volatile coin. If you are already using a large entry_pct to wait for dips before buying, the risk of filling at the top of a pump is lower, and pump guard adds less value.

Enabling it

In Settings > Transaction Params > Pump Guard, or in config.toml:

[buy.pump_guard]
enabled        = true
threshold_pct  = 20.0
window_slots   = 4

You can also save this as a preset to toggle it per coin.

Settings

Setting	Default	What it does
enabled	false	Turn pump guard on for auto-rebuy buys.
threshold_pct	20.0	How big a price jump, in percent, triggers the guard. A spike of at least this size that stays elevated counts as a pump.
window_slots	4	How many slots (~1.6 seconds) the price jump is measured over. Lower is more reactive (catches sharp spikes, may trip on noise); higher catches slower pumps too. Must be between 1 and 512.

Good to know

• Manual buys always go through. Pump guard only stops auto-rebuy. If you see a pump and want to chase it manually, the Buy button works as normal.
• You decide when to re-enter. The guard never resumes auto-rebuy on its own. Press W again when you want back in.
• Applies to buys only. There is no sell-side pump guard. Sells continue normally during a pump.