Connecting to HTX
To connect HTX to JetScalp, create an API key in your HTX account and enter it in the connection settings.
HTX issues a key pair:
- Access Key — the API key identifier.
- Secret Key — the secret key used to sign requests.
In JetScalp the HTX connection has two sections: Spot (spot trading) and Futures (USDT-M, USDT-margined perpetual futures). They share one key: the Read and Trade permissions in HTX apply to the whole account.
Official documentation: HTX API .
1.Open API key management
Sign in on the HTX website and go to Profile → API Management (or open the HTX API keys page ). Each account can create up to 20 API keys.
2.Create an API key
Click Create API Key and create a key generated by HTX (an Access Key and Secret Key pair). In the Note field, enter a name, for example JetScalp. The name is only for you — to tell keys apart.
Do not choose the option with your own Ed25519 public key: JetScalp signs requests with the Secret Key and does not support self-generated keys.
3.Configure permissions
| Permission | Description |
|---|---|
| Read | Account, balance, order and trade information. |
| Trade | Placing and canceling orders, transfers between accounts. |
| Withdraw | Withdrawing funds. |
For JetScalp, enable:
- Read
- Trade
- Withdraw
Permission names may differ depending on the version of the HTX interface.
Important: JetScalp does not need the withdrawal permission (Withdraw) — do not enable it.
4.Restrict access by IP
Bind the key to the public IP address JetScalp connects to HTX from. Up to 20 IP addresses can be bound to one key. If JetScalp works through a proxy, enter the IP address HTX sees when you connect through that proxy.
A key without IP binding expires after 90 days.
If you do not know which IP to enter, find it out first: with a wrong IP, HTX rejects the connection.
5.Confirm creation and save the key
Complete the security verification (for example, an SMS or email code and a Google Authenticator code). HTX shows the Access 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 futures account settings
The Futures section works through the HTX V5 API, which is designed for the Multi-Assets Collateral mode.
- If the futures account is in the old Single-Asset Collateral mode, JetScalp shows a warning. If orders are rejected, switch the USDT-M account to Multi-Assets Collateral mode in the HTX settings.
- JetScalp supports an HTX futures account only in One-way position mode. If hedge mode is enabled, the connection is not established and JetScalp shows a message about it. Switch the position mode in the HTX settings and connect again.
- JetScalp places HTX USDT-M orders in cross margin.
The account modes are your HTX settings; JetScalp does not change them.
7.Add the connection in JetScalp
Open Settings → Connections, click Add connection below the connection list and click the tile HTX. 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. |
| Access Key | The Access Key from HTX. |
| Secret Key | The Secret Key from HTX. |
| Proxy | A proxy from the list or None. See Proxy settings. |
HTX has two markets, so the connection settings have two sections — Spot and Futures, each with its own switch and state. Turn off the section of a market you do not trade: JetScalp will not connect to it, and the section's fields are kept.
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:
- HTX is connected.
- The account balance is shown.
- Open positions are shown.
- Orders are placed and canceled.
If the connection does not work
Invalid Access 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 has the Trade permission.
Ed25519 key used
JetScalp works only with keys generated by HTX (Access Key and Secret Key). If you created an Ed25519 key, create a regular one instead.
The key has no spot account
The message “HTX Spot: the key has no spot account. Connection stopped.” means HTX returned no spot account for the key. Check that the HTX account the key was created in has a spot account. If you do not trade spot, turn off the Spot section.
Futures account settings
If JetScalp reports hedge mode or the old collateral mode on the HTX USDT-M account, change the corresponding setting in HTX (see step 6).
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 expired
Open HTX → API Management and make sure the key exists and is active. A key without IP binding expires after 90 days — create a new one and bind it to an IP if you can.
Security
Never share your Access 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 HTX right away and create a new one.