Complete User & Technical Documentation
1. Introduction
What is ABFutureBot?
ABFutureBot is a sophisticated, automated cryptocurrency trading bot designed for the futures market. It operates as a desktop application, giving users full control over their trading strategies and, most importantly, their exchange API keys.
The core philosophy behind ABFutureBot is to provide a powerful, secure, and user-friendly tool that empowers traders to execute complex strategies 24/7 without being tied to their screens.
High-Level Architecture
The project is built on a security-first, hybrid architecture that separates sensitive operations from core trading logic.
- Desktop Application (
ABFutureBot): This is the main application that the user runs. It contains a local backend server (Python/FastAPI) for trading logic, a modern frontend for the dashboard, and crucially, stores all exchange API keys encrypted locally on the user's machine. - Authentication & Payments Server (
ABFutureBotAuthServer): This is a separate, dedicated, and secure server whose sole responsibility is to handle user registration, login, password management, and subscription management via Stripe.
This separation ensures that a user's trading capital and exchange access are completely isolated from their account credentials, providing a robust layer of security.
2. Getting Started: Setup and Configuration
Step 1: Download and Install
The application is distributed as a single ABFutureBot.exe file. Simply download it from the official website (https://www.abfuturebot.com) and place it in a convenient location on your Windows computer. No complex installation is required.
Step 2: Registration and Login
On first launch, you will be prompted to register for an account. You will need to provide a username, a valid email address, and a secure password. After registration, you will be directed to the subscription page to activate your account.
Step 3: API Key Setup (Crucial)
IP Whitelisting
For maximum security, you must whitelist the IP address your bot is running from.
- Once you are logged into the application, the "My IP Address" widget on the dashboard will display your computer's public IP address.
- Log in to your Crypto.com Exchange account and navigate to API Management.
- Create a new API key or edit an existing one, adding the IP address from the bot's dashboard to the IP whitelist.
IMPORTANT: If your home IP address changes, you will need to update the whitelist on the exchange. For uninterrupted 24/7 operation, running ABFutureBot on a Virtual Private Server (VPS) with a static IP address is highly recommended.
Saving Keys in the Application
In the ABFutureBot dashboard, navigate to the bot card you wish to configure, enter the API Key and Secret Key, and click "Save Keys". The keys will be securely stored in your operating system's credential manager.
3. The Dashboard Explained
The dashboard is your command center for monitoring and managing all trading activity.
Header Controls & Widgets
- Start/Stop All: Conveniently start all enabled bots or stop all currently running bots.
- Manage Subscription: Opens the secure Stripe portal to manage your payment details.
- Backtester & Tax Center: Opens the dedicated tools in a new window.
- Total Balance: Displays the combined USD value of all assets across your configured sub-wallets.
- Fear & Greed Index: A market sentiment gauge. "Extreme Fear" can suggest a buying opportunity, while "Extreme Greed" can signal a potential market correction.
- BTC Dominance: Shows Bitcoin's market share. A falling dominance can signal an "altcoin season." You can optionally provide a free API key from CoinStats to enable a 90-day historical trend chart for this widget.
- Trending on CoinGecko: The sidebar widget shows a live-updated list of the top 7 trending cryptocurrencies, providing insight into which assets are currently capturing the market's attention.
4. Configuring a Bot
Each bot is configured via its own "bot card" on the dashboard. Key parameters include:
- Trading Pair: The cryptocurrency pair the bot will trade (e.g.,
BTC/USDT). - Interval: The timeframe for each candlestick the bot analyzes (e.g.,
5m,1h,4h). - Strategy: The core logic the bot uses to find trades (e.g., MACD Crossover, RSI Mean Reversion). Different strategies are available based on your subscription plan.
- Buy Order Size (%): The percentage of your available stablecoin balance to use for a single BUY order.
- Is Memecoin: A flag that adjusts the bot's volatility parameters for highly volatile or newer assets.
- Risk Ranking (1-4): The core of the bot's decision-making process. It controls how cautiously the bot acts on a trading signal.
- Take-Profit %: Automatically sells a position when it reaches a specified percentage of profit. (Trader+ feature)
- Stop-Loss Type: A critical risk management tool to limit losses. You can choose between a 'Standard' stop-loss or a 'Trailing' one that locks in profits as price rises. (Trader+ and Pro features)
- SL ATR Multiplier: Sets the stop-loss distance based on market volatility using the Average True Range (ATR), creating a more dynamic and responsive risk buffer.
5. Core Trading Strategies
The bot supports multiple trading strategies, each with its own tiered risk ranking system. Please see the Features page for a full deep-dive into each strategy and its risk rankings.
6. Advanced Tools
Backtester
The dedicated backtesting page allows you to simulate strategies against historical data to see how they would have performed. This tool is essential for refining your strategies before deploying them with real capital.
Tax Center
The Tax Center simplifies your financial reporting by generating a capital gains report from your trade history. It fetches all executed trades for a selected period and calculates the capital gain or loss for each closed position.
Log Viewer
Accessible from each bot card, the Log Viewer provides a real-time window into a specific bot's operations, showing its "thoughts" and actions. It is essential for debugging and understanding bot behavior.
7. Security Overview
- Non-Custodial: We never have access to your funds. The bot trades directly on your exchange account.
- Local Key Storage: Your sensitive API keys are encrypted and stored in your operating system's native, secure credential manager.
- Separated Authentication: The server that handles your login password has no connection to the trading systems or your API keys.
- Secure Payments: All subscription payments are processed by Stripe. We do not handle or store any of your credit card information.
8. Subscription Management
You can manage your subscription at any time by clicking the "Manage Subscription" button in the dashboard header. This will open a secure customer portal hosted by Stripe, where you can update your payment method, view your invoice history, or cancel/change your plan.
9. FAQ
- Do I need to keep my computer on? Yes. As a desktop application, ABFutureBot must be running for it to execute trades. For 24/7 operation, running the application on a low-cost Virtual Private Server (VPS) is the recommended approach.
- Which exchanges are supported? Currently, ABFutureBot is fully integrated with the Crypto.com Exchange. Support for other major exchanges is planned for future releases.
- Is this financial advice? No. ABFutureBot is a tool for executing *your* strategy. It is provided for educational and informational purposes only. All trading involves risk, and you are solely responsible for your decisions and outcomes.