Connecting to Bybit
To connect Bybit to JetScalp, create an API key in your Bybit account and enter it in the connection settings.
Bybit issues a key pair:
- API Key — the API key identifier.
- Secret Key — the secret key used to sign requests.
JetScalp needs a system key (System-generated API Key, HMAC), which consists of an API Key and a Secret Key.
JetScalp works with the Bybit Unified Trading Account and trades spot and USDT and USDC perpetual contracts; inverse contracts are not supported.
Official guide: How to create your API key .
1.Open API key management
Log in to Bybit and open API Management .
API keys can only be created on the Bybit website, not in the mobile app. A new account may be unable to create keys for the first 48 hours after registration.
2.Create an API key
Click Create New Key, choose System-generated API Keys, then Connect to Third-Party Applications. If JetScalp is not in the list of applications, choose the option that creates a regular system-generated API key.
Enter a name for the key, for example JetScalp.
3.Configure permissions
To trade, JetScalp needs access to account information, orders and positions. Example settings:
- Account / Read
- Orders
- Positions
- Withdraw
Permission names may differ depending on the version of the Bybit interface.
Important: JetScalp does not need the withdrawal permission (Withdraw / Withdrawal) — do not enable it.
4.Restrict access by IP
If Bybit offers to restrict the key to trusted IP addresses, enter the IP address JetScalp connects to Bybit from. If JetScalp works through a proxy, enter the IP address Bybit sees when you connect through that proxy.
If you do not know which IP to enter, find it out first: with a wrong IP, Bybit rejects the connection.
5.Confirm creation and save the key
Click Submit and confirm with your Google Authenticator 2FA code. Bybit creates the key and shows the API Key and Secret Key. Copy both keys right away.
Important: The Secret Key is shown only once. If it is lost, delete the key and create a new one.
6.Check the position mode
JetScalp supports Bybit futures trading only in One-Way Mode, which is the Bybit default.
Bybit sets Hedge Mode down to an individual contract, so JetScalp checks it in two steps:
- on connect, by open positions: if at least one is open in Hedge Mode, the connection is not established and JetScalp shows “Bybit: the account is in Hedge Mode. JetScalp supports only One-way Mode — switch the position mode in the Bybit settings. Connection aborted.”;
- after connecting, per symbol: JetScalp does not send orders for a contract in Hedge Mode and shows “Bybit: BTCUSDT is in Hedge Mode. JetScalp supports only One-way Mode — switch the position mode of the symbol in the Bybit settings.”. Once the contract is switched to One-Way Mode, it can be traded again.
To switch the mode, open the Bybit derivatives trading page and select One-Way Mode in the Position Mode settings. As a rule, the mode cannot be changed while the contract has an open position or active orders.
The position mode is a setting of your Bybit account; JetScalp does not change it.
7.Add the connection in JetScalp
Open Settings → Connections, click Add connection below the connection list and click the tile Bybit. The connection appears in the list, and its settings appear on the right.
Fill in the connection settings:
| Field | Value |
|---|---|
| Name | The connection name in the list. By default it is the exchange or broker name; you can change it. |
| API Key | The API Key from Bybit. |
| Secret Key | The Secret Key from Bybit. |
| Proxy | A proxy from the list or None. See Proxy settings. |
8.Turn on the connection and check
Turn the connection on with the switch on the right of its row in the list. The state appears under the connection name: first connecting…, then connected. If the connection fails, the error text appears there — the full text is shown in the tooltip and in the header of the connection settings. For all states, see Connections.
Check that:
- Bybit is connected.
- The account balance is shown.
- Open positions are shown.
- Orders are placed and canceled.
If the connection does not work
Invalid API Key or Secret Key
Check that both keys are copied completely and without extra spaces.
Insufficient permissions
If quotes and account information work but orders are not placed, check that the key allows order and position operations.
Hedge mode is enabled
If JetScalp reports that the Bybit account or a symbol is in Hedge Mode, switch the position mode to One-Way Mode (see step 6).
Portfolio margin
If JetScalp reports “The Bybit account uses portfolio margin: margin mode is changed on the Bybit website.” when you change the margin mode, the account uses Portfolio Margin. This is an account-wide setting: the margin mode can only be changed on the Bybit website.
IP restriction
If the key has an IP restriction, make sure the IP address of the computer or proxy is in the allowed list.
API key deleted
Open Bybit → API Management and make sure the key still exists. If the key has been compromised, delete it there and create a new one.
Security
Never share your API Key and Secret Key — not in chats or Telegram, not with support, not on forums, in screenshots or public repositories.
JetScalp does not need the withdrawal permission — do not enable it.
If the key may have reached anyone else, delete it in Bybit right away and create a new one.