Parameter Configuration

Polysnipes uses config.py to control how the bot operates. Set these before you start the bot.

Wallet settings

• TARGET_ADDRESS The wallet address you want to mirror. The bot continuously tracks this trader’s positions.

• PROXY_WALLET Your own wallet address that executes trades. This is where mirrored positions will be placed.

• PRIVATE_KEY The private key for the wallet linked to your Polymarket. The bot uses it to sign transactions.

Trade settings

• FETCH_LIMIT Defines how many recent trades or positions the bot fetches per cycle. Helps control data load and responsiveness.

• CHECK_INTERVAL Sets how often (in seconds) the bot checks the target wallet for new trades. A shorter interval means faster mirroring but higher resource usage.

• MAX_USDC

  • The maximum USDC amount the bot can allocate to a single trade.

  • Important: copying only triggers if the target’s trade size is >= MAX_USDC.

  • This prevents tiny target trades from triggering your bot.

  • It also caps your maximum buy size per copied trade.

• MAX_PERCENT

  • Defines your buy amount as a percentage of your portfolio balance.

  • Example: If set to 10%, the bot allocates 10% of your wallet balance to each mirrored trade.

  • This ensures proportional risk management across trades.

• COPY_LIMIT The maximum number of trades the bot will replicate before stopping. Useful for limiting exposure during a session.

Example: how the MAX_USDC rule behaves

You set MAX_USDC = 10.

• Target buys 5 USDC → your bot does nothing.

• Target buys 25 USDC → your bot can buy (up to your limits).

Gas & transaction settings

• GAS_LIMIT The maximum gas units allowed per transaction. Controls transaction complexity and cost.

• GAS_PRICE The gas price the bot uses when submitting trades. Higher values increase speed but cost more.

Suggested config values (safe defaults)

• FETCH_LIMIT = 1 Beginners should start by fetching only one trade per cycle. This minimizes system load and ensures the bot processes trades sequentially, making it easier to monitor behavior.

• CHECK_INTERVAL = 1 A 1‑second interval provides near‑real‑time monitoring without overwhelming RPC endpoints. It balances responsiveness with stability, so new users can see trades mirrored quickly while keeping resource usage manageable.

• MAX_USDC = 10 Setting a low cap (10 USDC) ensures that beginners don’t risk large amounts on a single trade. Importantly, the bot only triggers a buy if the target’s trade size is greater than or equal to this cap, preventing overspending and keeping exposure small.

• MAX_PERCENT = 5 Allocating just 5% of your portfolio per trade keeps risk proportional. This way, even if a mirrored trade goes against you, losses are contained to a small fraction of your balance.

• COPY_LIMIT = 1 Limiting replication to a single trade per session gives beginners control and prevents runaway exposure. It’s a safe way to test the bot’s behavior before scaling up.

Gas settings (default values for POL network)

• GAS_LIMIT = 5000 A conservative gas limit ensures transactions remain simple and cost‑effective. Beginners avoid complex, high‑gas trades that could fail or drain funds.

• GAS_PRICE = 110000000000 (110 gwei) 110000000000 is 110 gwei expressed in wei. This value balances speed and cost for typical transactions.