Bybit_AutoTrade: Instructions file for GitHub Copilot

Bybit Trading Bot - AI Agent Instructions

Architecture Overview

This is a unified Bybit V5 trading bot with Telegram interface, LLM integration, and MCP server capabilities. The architecture follows a public-first design with clear private endpoint gating.

Core Components

• src/main.py: Single unified entrypoint with EnhancedBybitBot class - handle Telegram commands and natural language queries
• src/bybit_client.py: Bybit V5 REST client with authentication, simulation modes, and strict public/private endpoint separation
• src/llm.py: OpenAI-compatible client (default: Novita GPT-OSS) with error handling for balance issues
• src/config.py: Environment-based configuration with public_only mode toggle
• tools/mcp_server.py: Optional MCP server for external AI tool integration

Key Architectural Decisions

Public-First Design: Bot defaults to BYBIT_PUBLIC_ONLY=true mode. Private endpoints require explicit configuration and show clear guidance when unavailable.

LLM Intent Analysis: Natural language queries go through analyze_user_intent() which uses comprehensive API documentation context to route to appropriate Bybit endpoints.

Dual Authentication Modes:

• Public-only: Market data, server time, tickers (no API keys needed)
• Full mode: Wallet balance, positions, trading (requires BYBIT_API_KEY/BYBIT_API_SECRET)

Essential Editing Patterns

When Editing Existing Files (DO NOT CREATE NEW FILES)

Main.py Pattern: Always edit src/main.py directly. DO NOT create enhanced_main.py, main_complete.py, or similar variants.

Single Source of Truth: Update existing files rather than creating duplicates. The codebase follows this principle strictly.

API Client Extension Pattern

# In bybit_client.py - Add new endpoints following this pattern:
async def new_endpoint(self, category: str, symbol: str) -> Dict[str, Any]:
    if self.simulation_mode:
        return self._simulate_endpoint_data(symbol)
    
    if self._client is None:
        return {"retCode": 10002, "retMsg": "Client not initialized", "result": {}}
    
    # Implementation with proper error handling