The Smart Grid Trading Bot that Works For You!

Our licenses are tied to your unique license key, which you receive after purchase. Activation occurs by entering the key into the program. Each license is assigned an activation limit on different computers.

Depending on the plan purchased, you can activate the bot on:

• 1 device simultaneously (for monthly and 3-month plans)
• 2 devices simultaneously (for 6-month plans)
• 3 devices simultaneously (for annual and 2-year plans)
• 5 devices simultaneously (for lifetime license – activation required on each new device)

The licensing system verifies a unique device ID. If the number of active devices exceeds the limit, the program will not launch on a new computer.

ATHgrid licenses do not auto-renew. Before your license expires, you will receive an email reminder with a link to a page where you can purchase a renewal. To continue using the bot, simply purchase a new license that suits your needs. Upon purchasing a new license, its validity will be automatically extended.

The ATHgrid program automatically creates backups of key state files (e.g., transaction history, positions) and the license file (license_data.json). You can configure these backups to be sent to your email after each transaction or daily, protecting your data in case of hardware failure or file corruption.

The license_data.json file contains your license key and activation token, as well as the device ID on which the license was activated. It is crucial for running the bot without re-activation.

Important: Although the license_data.json file can be moved, the program will only run on the device where the license was activated and registered according to the activation limit. If you lose your license key, you can use this file to regain access on a registered device.

Where to find API keys on Binance?

• Log in to your Binance account.
• Go to Profile (person icon in the top right corner) → API Management.
• Create a new API key (e.g., “System Bot”).

What permissions should I grant API keys?

• Enable Enable Reading and Enable Spot & Margin Trading options.
• DO NOT enable Enable Withdrawals.
• Recommendation: Whitelist IP addresses if the bot runs on a static IP. You can find your current IP in the bot application under the “Check current IP” button.

What to do if I get an “Invalid API keys!” or “API key authorization error” error?

• Check if the API Key and Secret Key were copied correctly (without extra spaces).
• Ensure API keys are active and have the required permissions.
• If you are using an IP whitelist, confirm that the bot’s IP is on the list.

Click the “Add new pair” button in the main application window. Enter the base asset symbol (e.g., BTC, ETH, LTC) and select the quoted currency (e.g., USDC, USDT). If a saved configuration exists for this pair, the bot will ask if you want to apply it.

• Min Price: The lowest price for buy orders.
• Max Price: The highest price for sell orders.
• Grid Percent: The percentage distance between grid levels (e.g., 2% means each level is 2% higher).
• Amount per Level: The amount in the quoted currency (e.g., USDC) invested in one buy order at each grid level.

• Ensure all fields (API keys, symbol, grid parameters) are filled with correct values.
• Check if you have sufficient quoted currency balance (e.g., USDC) in your account.
• Check logs (bot_log_<SYMBOL>.log or console) for errors.

• Buy Orders: Active buy orders awaiting execution.
• Filled Positions: Purchased positions awaiting sale (or with a sell order already placed).
• History: Recent buy and sell transactions executed by the bot.
• Grid Level Overview: Status of each grid level (active orders, filled positions, profit).

• 🟢 Light Green: Active buy order.
• 🔴 Light Red: Active sell order.
• 🔵 Light Blue: Filled buy position (awaiting sale).
• 🟡 Light Yellow: Filled sell position (profit realized).
• ⚪ Light Gray: Inactive level.

When enabled, profits from previous transactions are reinvested, increasing the amount for subsequent grid levels. This works on the principle of compounding interest, which can increase profits over the long term.

• Displays historical price data, current price, and order levels.
• Updates in real time via WebSocket, fetching historical data directly through your Binance account. If it doesn’t update, check logs for WebSocket or data fetching issues, and your internet speed.
• Change the interval using the dropdown list (stop the bot, change interval, and restart).

• 📜 Check logs: Review bot_log_<SYMBOL>.log and the console for Error or Warning messages.
• 🌐 Check internet: Ensure you have a stable connection.
• 🖥️ Check Binance status and your IP: Visit the Binance status page and compare the IP assigned to your API (your IP might change if you’re not using a static IP). Update if required.
• 🔄 Synchronize state: Restart the bot in case of a long disconnection (The bot has a built-in system to wait for reconnection in case of network disconnection).

• “Quantity too small” or “Insufficient balance” error:
  • Cause: Order amount below Binance minimum (LOT_SIZE) or insufficient funds.
  • Solution: Increase Amount per Level or decrease Grid Percent.
• “NOTIONAL value is below minimum” error:
  • Cause: Order value (price × quantity) below minimum (5-10 USDT/USDC).
  • Solution: Increase Amount per Level.
• “Duplicate sell order” error:
  • Cause: A sell order already exists at this level (e.g., manually placed).
  • Solution: The bot should cancel duplicates; check open orders on Binance if the problem persists and you see duplicate sell or buy orders at the same level, cancel them manually. The bot will then correctly set the orders again.

• Cause: Insufficient asset quantity due to fees or rounding.
• Solution:
  • Set MIN_SELL_QUANTITY to a low value (e.g., 0.00000001, if allowed).
  • Increase Amount per Level to cover fees.
  • Manually buy a small amount of base assets (e.g., BTC for BTC/USDC) on Binance to cover fee differences.

• Ensure the bot is running.
• Check logs for matplotlib, mplfinance, or WebSocket errors.
• Verify internet connection.
• Toggle chart visibility ( “Hide/Show Chart” button).

A general Binance API communication error. Check logs for details. Check your IP to ensure it hasn’t changed and compare it with your API settings on your Binance account. Update if required.

• Stop the bot.
• Delete trading_bot_state_<SYMBOL>.json and start_time_<SYMBOL>.json files.
• Restart the bot to reset its state.

Click Close tab in the notifications section and confirm.

Use the language selection dropdown on the splash screen or in the main window (top right corner).

Files (logs, state, configuration) are saved in the directory where the bot’s executable file is located.

Yes, the application supports multiple tabs for different trading pairs.

Grid Trading is a trading strategy that involves placing a series of buy and sell orders at different, pre-defined price levels. These levels create a “grid” around the current market price. The main principle is simple: “buy low, sell high” in an automated way. When the price falls, buy orders are activated. When the price rises, sell orders are activated, realizing profit from previously purchased positions.

ATHgrid implements the Grid Trading strategy dynamically and intelligently to maximize capital efficiency.

Dynamic Order Grid (Smart Capital Management)

• The bot analyzes the current market price.
• It places buy orders only at the two closest levels below the current price.
• It places sell orders only for the two closest, already held positions above the current price.
• At any given moment, a maximum of 6 orders (buy and sell) are active, so most of your capital remains free and is not frozen in distant orders.

Following an Uptrend

• When the price rises and sell orders are executed, the bot automatically shifts its active order grid upwards to continue trading at higher price levels.
• Compounding Interest through Reinvestment
• When the reinvestment option is enabled, the profit realized at a given level is automatically added to the base amount for that level. This means that the next buy order at the same level will be slightly larger, which over time leads to the effect of compounding interest.

Principle: For the strategy to work as intended, you should have enough capital in your account to cover buy orders at ALL levels of your grid.

Example: If your grid has 20 levels and the amount per level is $10, your capital allocated for the bot’s operation should be at least $200.

Risk: Price Exiting the Grid

• When the price rises above your highest level: The bot will sell the last position and stop trading. The bot will resume trading when the price returns to the designated grid range.
• When the price falls below your lowest level: The bot will buy positions at the lowest active levels and stop placing new buy orders. The bot will resume trading when the price returns to the designated grid range.

Risk: Insufficient Capital

• If there are insufficient funds at a given level, the bot will not place a buy order at that level.
• When you fund your account, the bot will resume trading at skipped levels.

Remember that ATHgrid is only a tool. You define the strategy, manage capital, and bear full responsibility for your trading decisions. Trading in financial markets always involves risk. Trade responsibly!