# EnjoyTrading Product Manual

## I. Product Overview

**Product Name**: EnjoyTrading
**Product Type**: Professional trading assistant tool for the OKX platform
**Supported Markets**: Perpetual futures + Spot trading
**Core Positioning**: A stable, efficient, and secure trading assistant built for professional traders, focused on rapid order execution, strategy trading, and secure API connectivity.

**Product Philosophy**: Enjoy Trading, Enjoy Professional
**Design Feature**: Tactical sidebar design that does not block the candlestick chart, making it easy to monitor the market and operate quickly.


## II. Quick Start

### 1. Obtain and Configure API Keys

#### Get an API Key from the OKX Official Website

1. Visit the [OKX official website](https://www.okx.com/)
2. Log in to your account → User Center → API
3. Create a new API key:
   - **Permissions**: The "Trade" permission must be granted
   - **IP whitelist**: Set it if you have a fixed IP; otherwise, there is no need to set it
   - **Passphrase**: Set a strong password and remember it
4. Record the following information:
   - API Key
   - Secret Key
   - Passphrase
5. Special notes:
   - OKX distinguishes between demo APIs and live APIs
   - For testing, switch to demo mode on the official website → obtain a demo API
   - For live trading, obtain a live API
   - Demo APIs and live APIs are not interchangeable and are completely independent

#### Network Environment Requirements

⚠️ **A VPN is required to connect to the OKX API:**

- OKX API servers are located overseas and require a stable international network connection
- A stable VPN or proxy service is recommended
- During the testing phase, thorough validation in the demo environment is recommended

### 2. Activate the Software

#### Obtaining an Activation Code

- **Product packaging**: When purchasing the physical product, the activation code is printed inside the box
- **Customer service**: Contact the customer service team to obtain an activation code

#### Activation Steps

1. Launch the software
2. Enter the activation code in the settings interface
3. Click the "Connect" button to complete activation

### 3. Connect the API and Start Trading

#### Connection Steps

1. Click the "Connect" button at the top of the interface
2. In the settings dialog, fill in:
   - API Key
   - Secret Key
   - Passphrase
   - Activation code
3. For testing, select "Demo" (strongly recommended)
4. Click "Save" and reconnect

#### Interface Feature Overview

**Shared Feature Areas (common to all modes)**

- **Contract selection**: Dropdown to select trading pairs, with support for favoriting frequently used tokens
- **Real-time price**: Displays the current price; green for up, red for down
- **Leverage info**: Displays the leverage multiplier and margin mode (futures mode)
- **Asset info**: Displays the available balance (spot mode)

**Futures Mode Features**

- **Funds & quantity settings**: Percentage mode or contract-count mode, with real-time calculation of required margin
- **Hedging panel**: Select hedge direction and ratio, execute a hedge with one click
- **Manual trading**: 6-button array supporting opening, closing, and canceling orders
- **Range order strategy**: Three strategy options with price settings

**Spot Mode Features**

- **Funds settings**: Percentage control, displaying buy/sell amounts and quantities
- **Manual trading**: 5-button operation, supporting buy/sell and all-in operations
- **Range order strategy**: Range settings adapted for spot trading


## III. Core Concepts Explained

### Differences Between Futures Mode and Spot Mode

- **Futures mode**: Supports leveraged trading, dual-direction long/short positions, cross/isolated margin modes
- **Spot mode**: Pure cash trading, no leverage, no borrowing, direct buying and selling of assets

### How to Use the SizingPanel

- **Percentage mode**: Slider to adjust the percentage of available balance (1-100%)
- **Contract-count mode**: Directly enter a fixed number of contracts to open
- **Calculation rules**: Automatically factors in the leverage multiplier and displays the estimated required margin in real time

### Hedging Feature Explained

- Select the hedge direction (hedge long positions or hedge short positions)
- Set the hedge ratio (1-100%)
- The system automatically calculates the number of contracts to hedge and executes a market-order hedge

### Spot Pure-Asset Mode

- No leverage or borrowing involved
- Buying uses the quote currency (USDT); selling uses the base currency (e.g., BTC)
- Supports 100% all-in operations

### The Three Range Order Mechanisms

1. **Standard range order (OCO)**: Simultaneously places a high-price limit short order and a low-price limit long order; when either is filled, the other is automatically canceled
2. **Bullish range order**: Low-price limit buy + high-price take-profit sell
3. **Bearish range order**: High-price limit sell + low-price take-profit buy

### Range Order Price Setting Methods

- **Symmetric mode**: Sets trigger prices symmetrically up and down, centered on the current price
- **Asymmetric mode**: Sets upper and lower band percentages independently, allowing different ranges
- **Manual mode**: Directly enter specific price values

### Frequently Used Trading Pair Settings

- Click the "Favorites" button to manage favorite trading pairs
- Supports adding/removing frequently used tokens
- Favorite trading pairs are marked with ★ and displayed at the top of the dropdown list
- Supports the F14+F17 shortcut to quickly cycle through favorite trading pairs


## IV. Futures Trading Mode in Detail

### 1. Quick Position Opening

- One-click long/short position opening in both directions
- Automatically calculates the order quantity based on the available balance percentage
- Cross/isolated margin mode switching
- Leverage multiplier adjustment

**Usage Steps**:

1. Select a trading pair at the top (e.g., BTC-USDT-SWAP)
2. Set the position-opening percentage via the slider (1%-100%)
3. Click the green "Long" button to go long, or the red "Short" button to go short
4. The system automatically calculates the optimal quantity based on the available balance, leverage multiplier, and current price

**Core Calculation Logic**:

```
Number of contracts = (Available balance × Leverage multiplier × Percentage%) / (Contract face value × Current price)
```

- **Contract-count mode**: Directly uses the fixed number of contracts set by the user
- **Margin prediction**: Displays the estimated required margin in real time to prevent over-ordering

**Interface Elements**:

- Mode switch: Percentage/contract-count radio buttons
- Percentage slider: Adjustable from 1-100%
- Balance display: Real-time available balance
- Margin display: Estimated required margin for long/short
- Contract count display: Calculated target number of contracts to open

### 2. Smart Position Closing

- Close positions by percentage
- Supports closing long and short positions separately
- One-click market-order full close

**Usage Steps**:

1. Check the current long/short position value
2. Set the closing percentage via the slider (1%-100%)
3. Click the corresponding button to close, or use market-order full close to exit quickly

### 3. Hedging Feature

- One-click hedge execution
- Supports long/short direction selection
- Customizable hedge ratio

**Execution Mechanism**:

1. **Position analysis**: Reads the current number of long/short positions
2. **Ratio calculation**: Calculates the number of contracts to hedge based on the user-set ratio

   ```
   Hedge contracts = Position quantity × Hedge ratio% / Contract face value
   ```

3. **Direction mapping**:
   - Hedge long positions → open short positions to hedge
   - Hedge short positions → open long positions to hedge
4. **Margin check**: Predicts whether the required margin is sufficient
5. **Market execution**: Uses a market order to execute the hedge immediately

### 4. Range Order Strategy (OCO)

**Execution Mechanisms of the Three Strategies**:

**Standard Range Order (OCO)**

- **Order structure**: High-price limit short order + low-price limit long order
- **Trigger logic**: When either order is filled, the other is automatically canceled
- **Suitable scenarios**: Unclear direction, waiting for a breakout or breakdown
- **Monitoring mechanism**: Background WebSocket monitors order status in real time

**Bullish Range Order (Long TP)**

- **Order structure**: Low-price limit long order + high-price take-profit algo order
- **Execution flow**:
  1. After the main order (long) is filled, the take-profit algo order is activated
  2. When the take-profit price is reached, the position is automatically closed at market price
- **Suitable scenarios**: Bullish market, waiting for a pullback buying opportunity

**Bearish Range Order (Short TP)**

- **Order structure**: High-price limit short order + low-price take-profit algo order
- **Execution flow**: Similar to the bullish range order, but in the opposite direction
- **Suitable scenarios**: Bearish market, waiting for a rebound selling opportunity

**Price Setting Modes**:

- **Symmetric mode**: Symmetric upper and lower bands, suitable for balanced strategies
- **Asymmetric mode**: Upper and lower bands can be set independently, suitable for directional strategies
- **Manual mode**: Precise control of specific price levels

### 5. Order Management

**6-Button Array Design**:

```
Open Long    Close Long    Cancel Latest
Open Short   Close Short   Cancel All
```

**Operation Logic**:

- **Open position**: Uses the number of contracts set in the SizingPanel, opens at market price
- **Close position**: Fully closes positions in the specified direction at market price
- **Cancel latest**: Cancels the most recent unfilled order
- **Cancel all**: Cancels all unfilled orders for the current trading pair

### 6. Trading Pair Switching

- Supports a custom list of favorite trading pairs
- One-click quick switching of trading pairs
- Supports all USDT perpetual futures: mainstream tokens such as BTC, ETH, SOL


## V. Spot Trading Mode in Detail

### 1. Quick Buy/Sell

**5-Button Operation Design**:

```
Buy      Buy All     Cancel Latest
Sell     Sell All    Cancel All
```

**Trading Logic**:

- **Buy**: Uses the quote currency (USDT) to buy the base currency, by percentage
- **Sell**: Uses the base currency to sell for the quote currency, by percentage
- **All-in operations**: Uses 100% of available assets for quick liquidation
- **Cancel operations**: Cancels the latest order or all orders

**Calculation Rules**:

- **Buy amount** = Quote currency available balance × Percentage%
- **Sell quantity** = Base currency available balance × Percentage%
- **Precision adjustment**: Automatically rounded down to the minimum trading unit
- **All-in operations**: Uses 100% of available assets

**Displayed Information**:

- Assets on both sides of the trading pair: BTC available + USDT available
- Operation quantities: Buy amount (USDT) + sell quantity (BTC)

### 2. Spot Range Order Strategy

**Range Orders Adapted for Spot**:

1. **Spot OCO range order**:
   - High-price limit sell + low-price limit buy
   - When either is filled, the other order is automatically canceled

2. **Spot bullish range order**:
   - Low-price limit buy + high-price take-profit sell
   - Automatically sets a take-profit sell after buying

3. **Spot bearish range order**:
   - High-price limit sell + low-price take-profit buy
   - Automatically sets a take-profit buy after selling

### 3. Order Management

- **Cancel latest**: Cancels the last pending order
- **Cancel all**: Cancels all unfilled orders

### 4. Trading Pair Switching

- Click the star to favorite spot trading pairs
- Switch via the dropdown selection
- Supports mainstream spot pairs: BTC-USDT, ETH-USDT, etc.


## VI. Secure API Mechanism

### 1. Dual-Mode Support

**Demo Mode**

- Zero-risk strategy testing
- Uses the OKX demo trading environment
- All features identical to live trading
- Suitable for beginner practice and strategy validation

**Live Mode**

- Real-money trading
- Connects to the OKX live trading environment
- Fund security guaranteed

### 2. Security Authentication

**HMAC-SHA256 Signature Authentication**

- All API requests use HMAC-SHA256 signatures
- Prevents requests from being tampered with
- Ensures request integrity

**Triple Authentication**

- API Key: Identifies the user
- Secret Key: Used for signing, never transmitted
- Passphrase: An additional security layer

**Activation Code Authorization**

- Supports an activation code verification mechanism
- Machine-code binding prevents key abuse
- Flexible authorization management

### 3. Request Protection

- **Automatic reconnection mechanism**: Automatically reconnects during network fluctuations, maintaining trading continuity
- **Timeout protection**: 10-second request timeout to prevent infinite waiting
- **Exponential backoff retry**: Automatically retries on failure with increasing intervals, avoiding pressure on the service

### 4. Data Security

- **Local storage**: All user information is stored locally and never uploaded to third-party servers
- **Encrypted API key storage**: Prevents key leakage
- **Local trade log recording**: Optionally save trade logs locally for easy review and reconciliation


## VII. Custom Trading Keyboard

**Product Positioning**: A physical trading keyboard built exclusively for EnjoyTrading, deeply integrated with the software and plug-and-play.

**Core Features**:

- **Plug and play**: No drivers required, works as soon as it is plugged in
- **Low latency**: Direct hardware connection, response time <100ms
- **Global listening**: No window focus required, operable from any interface
- **One-click operations**: Quickly execute trading commands via physical keys
- **Anti-mistouch**: Dual-key combination design prevents accidental presses

**Advantages**: Makes trading operations faster, more accurate, and smoother — an essential tool for professional traders.


## VIII. Other Core Features

### 1. Always-on-Top Window

- Click the pin button to keep the window always on top
- Click again to cancel always-on-top
- Sidebar design, compact and refined, does not block the candlestick chart
- Convenient for monitoring the market and operating at any time

### 2. Real-Time Data Refresh

- **Account balance**: Available balance updated in real time
- **Position info**: Long/short position quantities and values synced in real time
- **Latest price**: Current price displayed in real time
- **Order status**: Pending order status updated in real time

### 3. Multi-Language Support

- Chinese interface
- Extensible to other languages

### 4. Mode Switching

- Quickly switch between futures/spot modes via the top tab bar
- The interface and shortcut key mappings update automatically when switching
- Prevents cross-mode misoperation
- Futures and spot mode states are completely independent
- Each saves its own trading pairs, percentages, and strategy parameters


## IX. Frequently Asked Questions (FAQ)

### Connection and Setup Issues

**Q: "Network error" or timeout when connecting to the API?**

A: This is the most common issue. Please check:

1. Make sure you are using a VPN
2. Check whether the VPN/proxy settings are correct
3. Test the network connection: `ping www.okx.com`
4. Try switching to a different VPN server node

**Q: API keys are correct but the connection fails?**

A: Please check:

1. API permission settings: Make sure "Trade" permission is included
2. Whether the Passphrase is correct (case-sensitive)
3. Whether you are in the correct environment: Demo keys cannot be used for live trading, and vice versa
4. Whether the API key has expired or been disabled

**Q: Activation code is invalid or activation fails?**

A: Please:

1. Check whether the activation code was copied correctly (case-sensitive)
2. Confirm that the activation code has not expired or already been used
3. Contact customer service to obtain a new activation code

### Trading Feature Issues

**Q: "Insufficient margin" prompt when placing an order?**

A: This is a normal risk-control prompt. Please:

1. Check whether the available balance is sufficient
2. In futures mode, consider the leverage multiplier
3. Adjust the percentage or contract-count settings in the SizingPanel
4. Check whether any unfilled orders are occupying margin

**Q: Spot trading prompts "Quantity below the minimum trading unit"?**

A: Spot trading has a minimum trading quantity limit:

1. Check whether the buy amount is enough to purchase the minimum quantity of the token
2. Check whether the sell quantity meets the exchange's minimum requirements
3. Adjust the percentage settings or add funds

**Q: Range order did not execute automatically?**

A: Please check:

1. Whether the network connection is stable
2. Whether the order price settings are reasonable (do not set overly aggressive prices)
3. Whether the account balance supports the combined orders

### Interface and Operation Issues

**Q: Data not updating in time?**

A: Data update speed is related to network latency. If the delay is noticeable:

1. Check the stability of the network connection
2. Restart the software and reconnect

### Other Common Issues

**Q: How do I reset all settings?**

A: Delete the configuration files `config/user_prefs.json` and `config/license.json`, and the software will restart with default settings.
Note: Do not delete `config/client_config.json`.

**Q: Where can I view the log files?**

A: For software security reasons, log files have been disabled.

**Q: Have an issue not covered here, or unable to resolve it?**

A: Please contact customer service at any time; the technical team is always ready to solve your problems.


## X. Features and Services in Development

### Custom Quantitative Strategy Platform

- **Custom indicator development**: Supports developing proprietary technical indicators
- **Strategy backtesting engine**: Validates strategy effectiveness through backtesting on historical data
- **Automated execution framework**: Unattended strategy execution system
- **Risk management module**: Multi-layer risk control, intelligent stop-loss and take-profit

### Custom Personalization Features

- **Personalized interface**: Customize the interface layout according to your usage habits
- **Custom shortcuts**: Fully customizable shortcut key mapping

### Advanced Analysis Tools

- **Real-time charts**: Integrated professional candlestick charts and indicator analysis
- **Multi-account management**: Monitor multiple trading accounts simultaneously
- **Portfolio strategies**: Cross-product, cross-market portfolio investment strategies
- **Performance analysis**: Detailed trading performance statistics and analysis

### Cross-Platform Support

- **Multi-platform support**: Multi-platform support for a unified cross-platform trading assistant system
- **Cross-market support**: Expansion into trading assistant systems for stock and futures markets

Customers interested in experiencing these features are welcome to contact the team for details. We will provide you with exclusive demos and technical exchanges.


## XI. Contact Information

### Official Channels

- **Official website**: www.enjoytrading.fans
- **Service email**: echokeybroad@gmail.com

### Social Media

- **TikTok**: @EnjoyTrading (out of service)
- **YouTube**: EnjoyTrading (out of service)
- **X (Twitter)**: @CryptoToolsCN
                @CryptoToolsEN

### Online Shopping Platforms

- **Amazon**: Search for "EnjoyTrading"

### Technical Support

- **Working hours**: Monday to Friday, 9:00-18:00
- **Emergency support**: 7×24 email support


## Appendix: Software Security and Disclaimer

### Trading Assistant Tool Statement

EnjoyTrading is a professional trading assistant software designed to help traders execute trading decisions more efficiently. This software only provides trading interfaces and quick order placement features and does not involve any trading decision advice.

**Important Reminders**:

- This software does not provide investment advice or trading signals
- All trading decisions are made independently by the user
- Cryptocurrency trading carries high risks and may result in loss of funds
- Please fully understand the risks before trading

### Security Commitment

**API Key Security Protection**:

- Your API keys are stored entirely on your local device
- Never uploaded over the network or stored on our servers
- Local data is protected with encryption exceeding industry standards
- Hardware binding is supported to ensure authorization security

**Data Transmission Security**:

- All communication with the exchange is encrypted using HTTPS
- API requests are verified via digital signatures
- Additional security measures such as IP whitelisting are supported

**Software Integrity Protection**:

- Multi-layer code protection technology
- Runtime integrity verification
- Regular security updates and maintenance

### Solemn Warning

**To Potentially Malicious Developers**

We have noticed that certain individuals may have improper interest in our technical implementation. We hereby solemnly declare and warn:

**Deployed Technical Protection System**:

- Hardware binding circuit-breaker mechanism
- Dynamic code encryption technology
- Integrity verification network
- Environment adaptation protection

**Data Accuracy and Security Warning**:

Data received by genuine users is verified and calibrated through multiple layers. Any unauthorized modified version cannot guarantee data accuracy.

**Special warning**: Our system includes a data authenticity verification mechanism. Any unauthorized version may receive specially processed simulated data that may appear accurate in the short term but may contain systematic biases. Using such versions to make trading decisions may lead to unpredictable financial losses that cannot be avoided through conventional risk-control measures.

**Traceability and Monitoring Capabilities**:

Every legitimately authorized copy contains multi-layer identification marks. We have established a complete infringement monitoring system, capable of:

- Identifying unauthorized use
- Tracing the source of infringing copies
- Securing the complete chain of infringement evidence
- Monitoring the spread paths of infringing copies

**Serious Legal Response Position**:

We have completed comprehensive legal preparations, including but not limited to:

- Completed intellectual property registrations in major jurisdictions
- Established deep cooperation with professional intellectual property law firms
- Built a complete infringement evidence collection and preservation system
- Prepared tiered legal response plans for infringements of different scales

### Our Focus

We devote our primary resources to product feature development and user experience optimization, rather than technical confrontation with crackers. But this does not mean our protection is weak — we have chosen proven and effective solutions, and will continue to adjust as needed.

### To All Users

Choosing genuine software is not only a matter of compliance with the law, but also a responsible choice for your own trading security. Genuine users will receive:

- Accurate and reliable data services
- Timely and professional technical support
- Continuous and stable feature updates
- Complete and worry-free legal protection

We are committed to providing reliable tools for professional traders, and we believe good products deserve due respect.

---

**Enjoy Trading, Enjoy Professional** 🚀

**The ENJOYTRADING Development Team**