User Manual
Introduction
Welcome to JimSwap – your app for automated crypto trading.
With JimSwap, you can create your own trading bots and have them trade automatically on selected crypto exchanges. The following are currently supported:
- Binance
- ByBit
- Kraken
- KuCoin
The bots trade fully automatically using Market Orders and are completely configurable by you. Your privacy, security, and control are our top priorities.
Table of Contents
- 1. System Requirements
- 2. Login & Privacy
- 3. Subscription & Usage
- 4. JimSwap App Structure
- 5. Creating and Configuring Bots
- 6. App Settings
- 7. How Trading Works
- 8. Liability & Disclaimer
- 9. Support
1. System Requirements
- iOS or Android device with internet access
- Apple ID or Google ID for login
- API credentials for the desired exchanges
2. Login & Privacy
2.1 Login
Login is handled exclusively via "Sign in with Apple" or "Sign in with Google". No additional user accounts or passwords are required. No user data is stored for the login process; the app works solely with the authentication tokens provided by Apple or Google.
2.2 Privacy & Security
- No storage of personal data
- Encrypted communication between the app, server, and crypto exchanges
- API credentials are processed and stored in an encrypted format
3. Subscription & Usage
3.1 Subscription Model
A monthly subscription can be purchased through the in-app shop, which allows for:
- Up to 20 concurrent bots
- Up to 100 orders per bot
Management of the subscription (purchase, cancellation, refunds) is handled directly through Apple and/or Google.
4. JimSwap App Structure
4.1 App Login
4.1.1 Apple Login
Requires an active Apple account login. Only the confirmation token from Apple is used for login to ensure you are authenticated on your device. No user information is stored.
4.1.2 Google Login
Requires an active Google account login. Only the confirmation token from Google is used for login to ensure you are authenticated on your device. No user information is stored.
4.2 Portfolio Overview
4.2.1 Crypto Exchanges & Balances
Displays the total profit on the exchange. Displays the number of active bots on the exchange.
4.2.2 Portfolio Detail View
Clicking on an exchange card opens the exchange detail view. In the exchange detail view, all portfolio information is listed in detail.
4.3 Bots
4.3.1 Free Test Bot
Every app user can create one free test bot to test strategy settings. The free test bot can be deleted and recreated.
4.3.2 Bot List
Displays all created bots with their status: Running, Waiting, or Error. A new bot can be created via the "Add New Bot" button if you have an active subscription and have accepted the T&C and Privacy Policy. For detailed instructions, see "Bot Configuration".
4.3.3 Bot Details
Clicking on a bot in the bot list opens the detail view for that bot. In the bot detail view, you can control the bot and edit its strategy.
4.4 History
4.4.1 Trade History
Available filters include Bot Name, Coin, and Order Type (Bought, Sold). The filtered order history can be exported as a PDF.
4.4.2 Order Details
Clicking on an order opens the order detail view, which shows all detailed information about that order.
4.5 Settings
4.5.1 App Settings
Here you can manage Language, Dark Mode, Automatic Login (Biometric Login), T&C Agreement, and Privacy Policy Agreement.
4.5.2 Account Management
This section includes Legal Documents, Investments for ROI, Manage API Keys, Account Merging (to link Apple and Google IDs), and Subscription Management.
5. Creating and Configuring Bots
This section explains how to create and configure a new bot.
To activate a bot, you must connect to a crypto exchange. The following data is required:
- API Key
- API Secret
- Optional: API Passphrase
⚠️ You are solely responsible for the configuration and behavior of the bot. For increased security, you can restrict API key usage to this specific IP address: 217.154.94.178. IMPORTANT: For your security, the API key must NOT have withdrawal permissions enabled.
Official API documentation for the exchanges:
5.1 Bot Creation
5.1.1 Free Test Bot
Click the "Create Test Bot" button.
Select your Base Asset (e.g., BTC, ETH).
Select your Quote Asset (Stablecoin, e.g., USDT).
Next, configure your strategy parameters.
When you click "Create Bot", the bot will be created, and you will be taken to the bot detail view where you can review all settings and click the "Start" button.
To revise your strategy, you can stop the bot and click "Edit Settings".
5.1.2 Agreements and Legal
In the navigation, click on "Settings".
You can now read all necessary information under "View Legal Documents".
All documents are available in their latest version at www.jimswap.com.
It is not possible to create a bot until the T&C and Privacy Policy have been accepted.
5.1.3 Subscription Management
In the navigation, click on "Settings".
Click on "Subscription Management".
You can now purchase the subscription.
Once the purchase is confirmed, you can create a new bot under the "Bots" tab. It is important that an API key for the desired exchange has already been created. If a subscription is already active, the subscription management page will be displayed.
5.1.4 Creating an API Key
In the navigation, click on "Settings".
Click on "Manage API Keys".
For security reasons, biometric confirmation is required.
If an API key is present for an exchange, it will be marked in green. Clicking on an exchange allows you to save your API information.
You can exit the view by clicking "Save", "Cancel", or "Delete".
5.1.5 Entering Investments
In the navigation, click on "Settings".
Click on "Investments for ROI".
If an investment amount has already been entered, it will be displayed.
Clicking on an exchange allows you to enter and save your investment information.
You can exit the view by clicking "Save" or the back button.
5.1.6 Subscribed Bots
The "Create Bot" button appears as soon as all necessary agreements have been accepted and you have a valid subscription.
Click on "Create Bot". Choose a bot name ("Test Bot" is not allowed) and the exchange (an API key must be entered for it).
Select your Quote Asset (Stablecoin). Next, configure your strategy parameters.
When you click "Save", the bot is created, and you are taken to the bot detail view where you can review all settings and click the "Start" button.
To revise your strategy, you can stop the bot and click "Edit Settings".
5.2 Bot Strategy
Here is an explanation of the strategy parameters:
- Price Drop from ATH: Set the percentage below the last All-Time High at which the first order should be opened.
- Price Drop per Level: Set the percentage difference to be calculated between orders.
- Order Amount: Set your purchase amount in $. For example, 100 means the bot will use $100 for each order.
- Max. Open Orders: Set the maximum number of orders the bot is allowed to hold as "bought". Be aware that during larger market fluctuations, the bot may not be able to open new orders.
- Profit Target: Enter the percentage the bot should use to calculate the target selling price for a profit.
Clicking "Save" updates the strategy parameters and exits the strategy view. Clicking "Cancel" exits the strategy view without saving.
5.3 Bot Order History
When you click on "History" in the navigation, you can use the filters to adjust what is displayed. You can filter by bot name, coin, or status. With the download button, you can download the displayed orders as a CSV file.
If you click on an order, you can view all the information about that transaction.
5.4 Deleting a Bot
When a bot is deleted, all its related information is also permanently removed. It is recommended to download the order history beforehand. All API information, orders, and strategies will be deleted. All tax-relevant transactions must then be obtained directly from the exchange used. It is not possible to recover the information of a deleted bot.
6. App Settings
6.1 Language
In the navigation, click on "Settings".
You can now select the language. Click "Save" to update the settings.
6.2 Dark Mode
In the navigation, click on "Settings". You can now enable or disable Dark Mode. Click "Save" to update the settings.
6.3 Automatic Login
In the navigation, click on "Settings". You can now enable automatic login. You will no longer need to actively log in as long as your access token is valid (7 days). Click "Save" to update the settings.
6.4 Agreements
In the navigation, click on "Settings". You can read all necessary information under "View Legal Documents". All documents are available in their latest version at https://jimswap.com. It is not possible to create a bot until the T&C and Privacy Policy have been accepted, even with an active subscription.
6.5 Account Merging
In the navigation, click on "Settings".
Click on "Connect Another Account" if you wish to use both your Apple and Google accounts for the same user profile. Once you have logged in with both accounts, you will be logged out to log in again with your new user ID. When you now log in with either Apple or Google, you should see the same information in the app.
7. How Trading Works
The JimSwap Multi Spot Bot works exclusively with Market Orders.
7.1 Buy Order
The bot executes a market buy order. The purchase price is saved. A target selling price is automatically calculated based on your desired profit target.
7.2 Sell Order
As soon as the market reaches the target price, a market sell order is placed. Goal: Sell the entire amount of the purchased coin for a profit. The realized profit is documented.
8. Liability & Disclaimer
JimSwap provides the technical platform for automated bots. All settings and associated risks are the responsibility of the user. Please review your bot settings regularly and be aware of the risks of the crypto market.
9. Support
For questions or issues, please contact: