Protecting yourself from getting drained by spam buys

minBuyFilter, maxBuyFilter, minSellFilter, and maxSellFilter

The parameters minBuyFilter, maxBuyFilter, minSellFilter, and maxSellFilter allow you to control which trades are copied based on their size in Sol. They act as a range filter, ensuring you only copy trades within a specified size range. Here's a detailed breakdown of their purpose and usage:

Parameters:

1. minBuyFilter: The minimum size (in Sol) for buy trades that you want to copy. Trades smaller than this value will be ignored.

   • Example: minBuyFilter = 0.1 means only buy trades of 0.1 Sol or larger will be copied.

   • To disable this filter, set it to 0, which means no lower limit.

2. maxBuyFilter: The maximum size (in Sol) for buy trades that you want to copy. Trades larger than this value will be ignored.

   • Example: maxBuyFilter = 1000 means only buy trades up to 1000 Sol will be copied.

   • To disable this filter, set it to 0, which means no upper limit.

3. minSellFilter: The minimum size (in Sol) for sell trades that you want to copy. Trades smaller than this value will be ignored.

   • Example: minSellFilter = 0.1 means only sell trades of 0.1 Sol or larger will be copied.

   • To disable this filter, set it to 0.

4. maxSellFilter: The maximum size (in Sol) for sell trades that you want to copy. Trades larger than this value will be ignored.

   • Example: maxSellFilter = 500 means only sell trades up to 500 Sol will be copied.

   • To disable this filter, set it to 0.

Practical Use Case:

Suppose you set:

• minBuyFilter = 0.1

• maxBuyFilter = 1000

• minSellFilter = 0.2

• maxSellFilter = 500

• For Buys: The bot will only copy buy trades between 0.1 and 1000 Sol. Any buy trade below 0.1 Sol or above 1000 Sol will be ignored.

• For Sells: The bot will only copy sell trades between 0.2 and 500 Sol. Any sell trade below 0.2 Sol or above 500 Sol will be ignored.

Disabling the Filters:

To turn off a filter completely, set it to 0. For example:

• Setting minBuyFilter = 0 and maxBuyFilter = 0 will copy all buy trades regardless of their size.

• Setting minSellFilter = 0.5 and maxSellFilter = 0 will copy sell trades that are 0.5 Sol or larger, with no upper limit.

Benefits of Using These Filters:

• Avoid Noise: You can ignore small, insignificant trades (e.g., spammy 0.01 Sol transactions) that are not meaningful or profitable for copying.

• Control Risk: You can set an upper limit to avoid copying extremely large trades that might carry higher risk.

• Flexibility: Tailor the copied trades to your preferred trade size and strategy.

These filters give you precise control over the trade sizes your bot copies from the copywallet.

The buyPercentage parameter allows you to define the proportion of the copywallet's buy trade size that you want to copy. However, its effect is limited by the maxBuyAmount parameter, which caps the maximum size of your copied trade regardless of the percentage calculation. Here's a more detailed explanation of how this works:

---

buyPercentage

• Definition: Specifies the percentage of the copywallet's buy trade size that your bot will copy.

• Example:

  • If buyPercentage = 10 and the copywallet buys 100 Sol of a token, your bot will copy 10% of that trade, which is 10 Sol.

  • If buyPercentage = 50 and the copywallet buys 20 Sol, your bot will copy 50% of that trade, which is 10 Sol.

---

maxBuyAmount

• Definition: Sets an upper limit on the amount (in Sol) your bot will spend on any single buy trade, regardless of the buyPercentage.

• Example:

  • If maxBuyAmount = 1, your bot will buy no more than 1 Sol worth of the token, even if buyPercentage would have calculated a larger trade size.

  • This cap ensures you don’t accidentally execute large trades beyond your intended risk or budget.

---

How buyPercentage and maxBuyAmount Work Together

1. Step 1: Calculate the trade size based on the copywallet's trade and the buyPercentage.

2. Step 2: Check if the calculated amount exceeds maxBuyAmount.

3. Step 3: If the calculated amount is greater than maxBuyAmount, your trade size is limited to maxBuyAmount. Otherwise, use the calculated amount.

---

Practical Example

Scenario 1: Without Hitting the Max

• buyPercentage = 10

• maxBuyAmount = 50

• copywallet buys 200 Sol.

• Calculation:

  • 10% of 200 Sol = 20 Sol

  • Since 20 Sol is less than maxBuyAmount, your bot will buy 20 Sol.

---

Scenario 2: Hitting the Max

• buyPercentage = 10

• maxBuyAmount = 10

• copywallet buys 200 Sol.

• Calculation:

  • 10% of 200 Sol = 20 Sol

  • Since 20 Sol exceeds maxBuyAmount, your bot will buy only 10 Sol.

---

Scenario 3: Small Trade

• buyPercentage = 50

• maxBuyAmount = 100

• copywallet buys 10 Sol.

• Calculation:

  • 50% of 10 Sol = 5 Sol

  • Since 5 Sol is less than maxBuyAmount, your bot will buy 5 Sol.

---

Why Use These Parameters?

• buyPercentage: Gives you flexibility to scale your trades based on the size of the copywallet's trade.

• maxBuyAmount: Acts as a safeguard to prevent unexpectedly large trades, protecting your funds and managing risk.

Usage Notes

• To copy exactly the calculated percentage without capping, set maxBuyAmount to a very high number (e.g., 1,000,000 Sol).

• To disable percentage-based scaling and always buy a fixed maximum amount, set buyPercentage to 100 and adjust maxBuyAmount to your desired fixed limit.

This mechanism combines flexibility with risk control, ensuring that you can copy trades at a proportional level while staying within predefined limits.