Polybot Final

This repository now contains the extracted project files (the zip archives were unpacked and removed).

Project structure

• /home/runner/work/Polybot_Final/Polybot_Final/ → extracted patch files and tests
• /home/runner/work/Polybot_Final/Polybot_Final/Bot-main-fixed/ → full upstream project snapshot

Installation

1. Go to the repository root

   cd /home/runner/work/Polybot_Final/Polybot_Final

2. Create and activate a virtual environment

   python3 -m venv .venv
   source .venv/bin/activate

3. Install dependencies

   pip install --upgrade pip
   pip install -r Bot-main-fixed/requirements.txt

4. Create your environment file

   cp Bot-main-fixed/env.example .env

5. Edit .env and set at least the required values

   • POLYGON_PRIVATE_KEY
   • WALLET_ADDRESS
   • ALCHEMY_API_KEY
   • DASHBOARD_PASSWORD
   • Keep DRY_RUN=true for safe testing.

6. Run tests

   pytest -q

7. Start the API

   uvicorn main_fastapi:app --host 0.0.0.0 --port 8000

Environment variables

Required for live trading

• POLYGON_PRIVATE_KEY (wallet private key)
• WALLET_ADDRESS (wallet address)
• ALCHEMY_API_KEY (Polygon RPC access)
• DASHBOARD_PASSWORD (dashboard/API authentication)
• DRY_RUN=false (only when you are ready for real trading)
• AUTO_EXECUTE=true (only when you are ready for real trading)

Core strategy and risk settings

• REDEEM_ONLY
• MODE
• DRY_RUN
• AUTO_EXECUTE
• MIN_EV
• MIN_EDGE_PERCENT
• KELLY_MULTIPLIER
• KELLY_AVG_WIN_PCT
• KELLY_AVG_LOSS_PCT
• USE_BUCKETED_KELLY
• MAX_POSITION_USD
• MIN_TRADE_USD
• MIN_TRADE_SIZE_USD
• MIN_BALANCE_USD
• MAX_DAILY_RISK_USD
• MAX_RISK_PER_TRADE
• MIN_CONFIDENCE_FILTER
• POSITION_SCALING_FACTOR
• ADAPTIVE_SCALING
• MAX_CONCURRENT_POSITIONS
• DAILY_RISK_RESET_HOUR

Market filters and scan controls

• UP_DOWN_ONLY
• MIN_LIQUIDITY_USD
• MIN_VOLUME_USD
• SCAN_INTERVAL_SECONDS
• TIMING_MIN_SECONDS_BEFORE_CLOSE
• TIMING_MAX_SECONDS_BEFORE_CLOSE
• TIMING_STRONG_EDGE_OVERRIDE

Execution extensions (maker/endgame/adaptive/LP)

• MAKER_FIRST_ENABLED
• MAKER_WAIT_SECONDS
• MAKER_IMPROVE_CENTS
• MAKER_UPGRADE_TO_TAKER
• MAX_MARKET_AGE_SECONDS
• ENDGAME_SNIPER_ENABLED
• ENDGAME_MIN_SECONDS_LEFT
• ENDGAME_MAX_SECONDS_LEFT
• ENDGAME_MIN_EDGE
• ENDGAME_SCAN_INTERVAL
• RECENCY_FADER_ENABLED
• MM_REACTION_ENABLED
• LP_ENABLED
• LP_QUOTE_SIZE_USD
• LP_MAX_INVENTORY_USD
• LP_MIN_SPREAD_CENTS
• LP_REFRESH_SECONDS

Redeemer and treasury settings

• FULL_REDEEM_ENABLED
• FULL_REDEEM_INTERVAL_SECONDS
• MIN_REDEEM_BALANCE
• REDEEM_GAS_BUFFER_PERCENT
• STARTUP_REDEEM_ALL
• PIGGYBANK_ENABLED
• PIGGYBANK_WALLET
• PIGGYBANK_PCT

Optimization and backtesting

• BACKTEST_DAYS
• BACKTEST_MODE
• BACKTEST_MIN_LIQUIDITY
• BACKTEST_COMMISSION_BPS
• BACKTEST_OUTPUT_CSV
• HYPEROPT_ENABLED
• HYPEROPT_PARAMS
• WALKFORWARD_WINDOWS
• OPTUNA_SAMPLER
• OPTUNA_N_TRIALS
• OPTUNA_DIRECTION
• OPTUNA_VIZ_ENABLED
• OPTUNA_VIZ_FORMATS
• AUTO_APPLY_BEST
• VIZ_DIR

Other operational variables

• LOG_LEVEL
• POLYGON_RPC_URL
• EXECUTION_SLIPPAGE_BPS
• AGGRESSIVE_MODE
• TRADE_JOURNAL_PATH
• DAILY_SUMMARY_TXT
• USDC_ADDRESS
• HYPERLIQUID_ENABLED

Notes

• The canonical default values are in Bot-main-fixed/env.example.
• Start in dry-run mode first and validate behavior before enabling live execution.