BaseBot.ai

1. Clone and Setup

git clone https://github.com/afterdarksys/banditbot.git
cd banditbot
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Configuration

Copy the example configuration and set your environment variables:

cp config/dex_config.example.json config/dex_config.json

Create a .env file or set environment variables for your API keys and settings. See the Configuration section for details.

3. Initialize Database

python scripts/init_db.py

4. Run the Web Interface

python botapp/app.py

Visit http://localhost:5000 to see your dashboard.

5. Use CLI Tools

python -m tradingbot.cli.main --help
python -m tradingbot.cli.main dex-quote --provider 0x

6. Run Tests

python -m unittest -v

Creating a Strategy Plugin

Create a new file in src/tradingbot/plugins/strategies/:

from typing import Dict, Any, Optional
from tradingbot.interfaces.plugin import IStrategy

class MyCustomStrategy(IStrategy):
    @property
    def name(self) -> str:
        return "my_custom_strategy"
    
    @property
    def version(self) -> str:
        return "1.0.0"
    
    def initialize(self, config: Dict[str, Any]) -> None:
        # Initialize your strategy with config
        self.threshold = config.get("threshold", 0.5)
    
    def generate_signal(self, market_data: Dict[str, Any]) -> Optional[Dict[str, Any]]:
        # Your strategy logic here
        # Return a signal dict or None
        
        if self._should_buy(market_data):
            return {
                "signal": "BUY",
                "confidence": 0.8,
                "reason": "Custom indicator triggered"
            }
        
        return {"signal": "HOLD", "confidence": 0.0}
    
    def _should_buy(self, data: Dict[str, Any]) -> bool:
        # Your analysis logic
        return False

Creating a Chain Adapter Plugin

Create a new file in src/tradingbot/plugins/chains/:

from typing import Dict, Any
from tradingbot.interfaces.plugin import IChainAdapter

class MyDexAdapter(IChainAdapter):
    @property
    def name(self) -> str:
        return "my_dex"
    
    @property
    def version(self) -> str:
        return "1.0.0"
    
    def initialize(self, config: Dict[str, Any]) -> None:
        self.api_key = config.get("api_key")
        self.base_url = config.get("base_url")
    
    def get_quote(self, params: Dict[str, Any]) -> Dict[str, Any]:
        # Fetch price quote from your DEX
        # params: {"from": "ETH", "to": "USDC", "amount": 1.0}
        return {
            "price": 2000.0,
            "estimated_gas": 21000
        }
    
    def execute_swap(self, params: Dict[str, Any]) -> Dict[str, Any]:
        # Execute the swap
        return {
            "tx_hash": "0x...",
            "status": "pending"
        }