Follow Me - X (Twitter): @yourQuantGuy

---

Languages: 🇺🇸 English | 🇰🇷 한국어

---

📢 Sharing Notice

Sharing is encouraged! If you share or modify this code, please include attribution to the original repository. We encourage the growth of the open-source community, but please maintain respect and recognition for the original author's work.

---

Multi-Exchange Trading Bot

A modular trading bot that supports multiple exchanges including EdgeX, Backpack, Paradex, Aster, Lighter, GRVT, and Extended. The bot implements an automated strategy that places orders and automatically closes them at a profit.

Referral Links (Enjoy fee rebates and benefits)

EdgeX: https://pro.edgex.exchange/referral/QUANT

Instant VIP 1 Trading Fees; 10% Fee Rebate; 10% Bonus Points

Backpack: https://backpack.exchange/join/quant

You will get 35% fee rebates on all your trading fees

Paradex: https://app.paradex.trade/r/quant

You will get 10% taker fee discount rebates and potential future benefits

Aster: https://www.asterdex.com/zh-CN/referral/5191B1

You will get 30% fee rebates and points boost

grvt: https://grvt.io/exchange/sign-up?ref=QUANT

You will get 1.3x points boost; rebates (auto rebates system is expected to be launched in mid-Oct); access to private trading competition

Extended: https://app.extended.exchange/join/QUANT

10% fee discount; points boost (black box, but "you will get more points from affiliate referral program than using another account to refer yourself" quoted from the official documentation from Extended); access to private trading competition

ApeX: https://join.omni.apex.exchange/quant

30% fee rebates; 5% fee discount; points boost

Installation

1. Clone the repository:

   git clone <repository-url>
   cd perp-dex-tools

2. Create and activate virtual environment:

   First, make sure you are not currently in any virtual environment:

   deactivate

   Create virtual environment:

   python3 -m venv env

   Activate virtual environment (you need to activate the virtual environment every time you use the script):

   source env/bin/activate  # Windows: env\Scripts\activate

3. Install dependencies: First, make sure you are not currently in any virtual environment:

   deactivate

   Activate virtual environment (you need to activate the virtual environment every time you use the script):

   source env/bin/activate  # Windows: env\Scripts\activate

   pip install -r requirements.txt

   Paradex Users: If you want to use Paradex exchange, you need to create an additional virtual environment and install Paradex-specific dependencies:

   First, make sure you are not currently in any virtual environment:

   deactivate

   Create a dedicated virtual environment for Paradex (named para_env):

   python3 -m venv para_env

   Activate virtual environment (you need to activate the virtual environment every time you use the script):

   source para_env/bin/activate  # Windows: para_env\Scripts\activate

   Install Paradex dependencies

   pip install -r para_requirements.txt

   Apex Users: If you want to use Apex exchange, you need to install Apex dependencies:

   First, make sure you are not currently in any virtual environment:

   source env/bin/activate  # Windows: env\Scripts\activate

   Install Apex dependencies

   pip install -r apex_requirements.txt

4. Set up environment variables: Create a .env file in the project root directory and use env_example.txt as a template to modify with your API keys.

5. Telegram Bot Setup (Optional): To receive trading notifications, please refer to the Telegram Bot Setup Guide to configure your Telegram bot.

Strategy Overview

Important Notice: Everyone must first understand the logic and risks of this script so you can set parameters that are more suitable for yourself, or you might think this is not a good strategy and don't want to use it at all. As I mentioned on Twitter, I didn't write these scripts for sharing purposes, but because I'm actually using this script myself, so I wrote it, and then shared it. This script mainly focuses on long-term wear and tear. As long as the script continues to place orders, if the price reaches your highest trapped point after a month, then all your trading volume for that month will be zero-wear. Therefore, I believe that setting --quantity and --wait-time too small is not a good long-term strategy, but it is indeed suitable for short-term high-intensity volume trading. I usually use quantity between 40-60 and wait-time between 450-650 to ensure that even if the market goes against your judgment, the script can still place orders continuously and stably until the price returns to your entry point, achieving zero-wear volume trading.

The bot implements a simple trading strategy:

1. Order Placement: Places limit orders near the current market price
2. Order Monitoring: Waits for orders to be filled
3. Close Order: Automatically places close orders at the take-profit level
4. Position Management: Monitors positions and active orders
5. Risk Management: Limits maximum number of concurrent orders
6. Grid Step Control: Controls minimum price distance between new orders and existing close orders via --grid-step parameter
7. Stop Trading Control: Controls the price conditions for stopping transactions through the --stop-price parameter

⚙️ Key Parameters

• quantity: Trading amount per order
• take-profit: Take-profit percentage (e.g., 0.02 means 0.02%)
• max-orders: Maximum concurrent active orders (risk control)
• wait-time: Wait time between orders (prevents overtrading)
• grid-step: Grid step control (prevents close orders from being too dense)
• stop-price: When direction is 'buy', exit when price >= stop-price; 'sell' logic is opposite (default: -1, no price-based termination)
• pause-price: When direction is 'buy', pause when price >= pause-price; 'sell' logic is opposite (default: -1, no price-based pausing)

Grid Step Feature

The --grid-step parameter controls the minimum distance between new order close prices and existing close order prices:

• Default -100: No grid step restriction, executes original strategy
• Positive value (e.g., 0.5): New order close price must maintain at least 0.5% distance from the nearest close order price
• Purpose: Prevents close orders from being too dense, improving fill probability and risk management

For example, when Long and --grid-step 0.5:

• If existing close order price is 2000 USDT
• New order close price must be lower than 1990 USDT (2000 × (1 - 0.5%))
• This prevents close orders from being too close together, improving overall strategy effectiveness

📊 Trading Flow Example

Assuming current ETH price is $2000 with take-profit set to 0.02%:

1. Open Position: Places buy order at $2000.40 (slightly above market price)
2. Fill: Order gets filled by the market, acquiring long position
3. Close Position: Immediately places sell order at $2000.80 (take-profit price)
4. Complete: Close order gets filled, earning 0.02% profit
5. Repeat: Continues to the next trading cycle

🛡️ Risk Management

• Order Limits: Limits maximum concurrent orders via max-orders
• Grid Control: Ensures reasonable spacing between close orders via grid-step
• Order Frequency Control: Controls order timing via wait-time to prevent being trapped in short periods
• Real-time Monitoring: Continuously monitors positions and order status
• ⚠️ No Stop Loss: This strategy does not include stop-loss functionality and may face significant losses in adverse market conditions

Sample commands:

EdgeX Exchange:

ETH:

python runbot.py --exchange edgex --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450

ETH (with grid step control):

python runbot.py --exchange edgex --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450 --grid-step 0.5

ETH (with stop price control):

python runbot.py --exchange edgex --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450 --stop-price 5500

BTC:

python runbot.py --exchange edgex --ticker BTC --quantity 0.05 --take-profit 0.02 --max-orders 40 --wait-time 450

Backpack Exchange:

ETH Perpetual:

python runbot.py --exchange backpack --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450

ETH Perpetual (with grid step control):

python runbot.py --exchange backpack --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450 --grid-step 0.3

ETH Perpetual (with Boost mode enabled):

python runbot.py --exchange backpack --ticker ETH --direction buy --quantity 0.1 --boost

Aster Exchange:

ETH:

python runbot.py --exchange aster --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450

ETH (with Boost mode enabled):

python runbot.py --exchange aster --ticker ETH --direction buy --quantity 0.1 --boost

GRVT Exchange:

BTC:

python runbot.py --exchange grvt --ticker BTC --quantity 0.05 --take-profit 0.02 --max-orders 40 --wait-time 450

Extended Exchange:

ETH:

python runbot.py --exchange extended --ticker ETH --quantity 0.1 --take-profit 0 --max-orders 40 --wait-time 450 --grid-step 0.01

🆕 Hedge Mode

The new Hedge Mode (hedge_mode.py) is an trading strategy that reduces risk by simultaneously hedging trades across two exchanges:

How Hedge Mode Works

1. Opening Phase: Place maker order at selected exchange (e.g., Backpack)
2. Hedging Phase: After order fills, immediately place market order at Lighter to hedge
3. Closing Phase: Place another maker order at selected exchange to close position
4. Hedge Closing: Place market order at Lighter to close hedge position

Hedge Mode Usage Examples

# Run BTC hedge mode with Backpack
python hedge_mode.py --exchange backpack --ticker BTC --size 0.05 --iter 20 --max-position 1

# Run ETH hedge mode with Extended
python hedge_mode.py --exchange extended --ticker ETH --size 0.1 --iter 20

# Run BTC hedge mode with Apex
python hedge_mode.py --exchange apex --ticker BTC --size 0.05 --iter 20

# Run BTC hedge mode with GRVT
python hedge_mode.py --exchange grvt --ticker BTC --size 0.05 --iter 20

# Run BTC hedge mode with edgeX
python hedge_mode.py --exchange edgex --ticker BTC --size 0.001 --iter 20

Hedge Mode Parameters

• --exchange: Primary exchange (supports 'backpack', 'extended', 'apex', 'grvt', 'edgex')
• --ticker: Trading pair symbol (e.g., BTC, ETH)
• --size: Order quantity per trade
• --iter: Number of trading cycles
• --fill-timeout: Maker order fill timeout in seconds (default: 5)
• --sleep: Sleep time in seconds after each step (default: 0)
• --max-position: When this parameter is set, the hedging mode will gradually build a position up to the specified maximum size while performing the hedge. The unit is in the base asset. For example, when running BTC, setting it to 0.1 means it will gradually build a position up to 0.1 BTC while hedging.

Configuration

Environment Variables

General Configuration

• ACCOUNT_NAME: The name of the current account in the environment variable, used for distinguishing between multiple account logs, customizable, not mandatory

Telegram Configuration (Optional)

• TELEGRAM_BOT_TOKEN: Telegram bot token
• TELEGRAM_CHAT_ID: Telegram chat ID

EdgeX Configuration

• EDGEX_ACCOUNT_ID: Your EdgeX account ID
• EDGEX_STARK_PRIVATE_KEY: Your EdgeX api private key
• EDGEX_BASE_URL: EdgeX API base URL (default: https://pro.edgex.exchange)
• EDGEX_WS_URL: EdgeX WebSocket URL (default: wss://quote.edgex.exchange)

Backpack Configuration

• BACKPACK_PUBLIC_KEY: Your Backpack API key
• BACKPACK_SECRET_KEY: Your Backpack API Secret

Paradex Configuration

• PARADEX_L1_ADDRESS: L1 wallet address
• PARADEX_L2_PRIVATE_KEY: L2 wallet private key (click avatar, wallet, "copy paradex private key")

Aster Configuration

• ASTER_API_KEY: Your Aster API Key
• ASTER_SECRET_KEY: Your Aster API Secret

Lighter Configuration

• API_KEY_PRIVATE_KEY: Your Lighter API private key
• LIGHTER_ACCOUNT_INDEX: Lighter account index
• LIGHTER_API_KEY_INDEX: Lighter API key index

GRVT Configuration

• GRVT_TRADING_ACCOUNT_ID: Your GRVT trading account ID
• GRVT_PRIVATE_KEY: Your GRVT private key
• GRVT_API_KEY: Your GRVT API key

Extended Configuration

• EXTENDED_API_KEY: Your Extended API key
• EXTENDED_STARK_KEY_PUBLIC: Your Stark public key
• EXTENDED_STARK_KEY_PRIVATE: Your Stark private key
• EXTENDED_VAULT: Your Extended Vault ID

Apex Configuration

• APEX_API_KEY: Your Apex API key
• APEX_API_KEY_PASSPHRASE: Your Apex API key passphrase
• APEX_API_KEY_SECRET: Your Apex API key secret
• APEX_OMNI_KEY_SEED: Your Apex Omni key seed

How to get LIGHTER_ACCOUNT_INDEX:

1. Add your wallet address to the end of the following URL:

   https://mainnet.zklighter.elliot.ai/api/v1/account?by=l1_address&value=
   

2. Open this URL in your browser

3. Search for "account_index" in the results - if you have subaccounts, there will be multiple account_index values. The shorter one is your main account, and the longer ones are your subaccounts.

Command Line Arguments

• --exchange: Exchange to use: 'edgex', 'backpack', 'paradex', 'aster', 'lighter', 'grvt', or 'extended' (default: edgex)
• --ticker: Base asset symbol (e.g., ETH, BTC, SOL). Contract ID is auto-resolved.
• --quantity: Order quantity (default: 0.1)
• --take-profit: Take profit percent (e.g., 0.02 means 0.02%)
• --direction: Trading direction: 'buy' or 'sell' (default: buy)
• --env-file: Account configuration file (default: .env)
• --max-orders: Maximum number of active orders (default: 40)
• --wait-time: Wait time between orders in seconds (default: 450)
• --grid-step: Minimum distance in percentage to the next close order price (default: -100, means no restriction)
• --stop-price: When direction is 'buy', stop trading and exit the program when price >= stop-price; 'sell' logic is opposite (default: -1, no price-based termination). The purpose of this parameter is to prevent orders from being placed at "high points for long positions or low points for short positions that you consider".
• --pause-price: When direction is 'buy', pause trading when price >= pause-price and resume trading when price falls back below pause-price; 'sell' logic is opposite (default: -1, no price-based pausing). The purpose of this parameter is to prevent orders from being placed at "high points for long positions or low points for short positions that you consider".
• --boost: Enable Boost mode for volume boosting on Aster and Backpack exchanges (only available for 'aster' and 'backpack') Boost trading logic: Place maker orders to open positions, immediately close with taker orders after fill, repeat this cycle. Wear consists of one maker order, one taker order fees, and slippage.

Logging

The bot provides comprehensive logging:

• Transaction Logs: CSV files with order details
• Debug Logs: Detailed activity logs with timestamps
• Console Output: Real-time status updates
• Error Handling: Comprehensive error logging and handling

Q & A

How to configure multiple accounts for the same exchange on the same device?

1. Create a .env file for each account, such as account_1.env, account_2.env
2. Set ACCOUNT_NAME= in each account's .env file, such as ACCOUNT_NAME=MAIN.
3. Configure the API keys or secrets for each account in each file
4. Use different --env-file parameters in the command line to start different accounts, such as python runbot.py --env-file account_1.env [other parameters...]

How to configure multiple accounts for different exchanges on the same device?

Configure all different exchange accounts in the same .env file, then use different --exchange parameters in the command line to start different exchanges, such as python runbot.py --exchange backpack [other parameters...]

How to configure multiple contracts for the same account and exchange on the same device?

Configure the account in the .env file, then use different --ticker parameters in the command line to start different contracts, such as python runbot.py --ticker ETH [other parameters...]

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

This project is licensed under a Non-Commercial License - see the LICENSE file for details.

Important Notice: This software is for personal learning and research purposes only. Commercial use is strictly prohibited. For commercial use, please contact the author for a commercial license.

Disclaimer

This software is for educational and research purposes only. Trading cryptocurrencies involves significant risk and can result in substantial financial losses. Use at your own risk and never trade with money you cannot afford to lose.