Подключение к HTX
Чтобы подключить HTX к JetScalp, создайте API-ключ в личном кабинете HTX и укажите его в настройках подключения.
HTX выдаёт пару ключей:
- Access Key — идентификатор API-ключа.
- Secret Key — секретный ключ для подписи запросов.
В JetScalp у подключения HTX две секции: Спот (спотовая торговля) и Фьючерсы (бессрочные фьючерсы USDT-M с маржой в USDT). Ключ у них один: права Read и Trade в HTX действуют для всего аккаунта.
Официальная документация: HTX API .
1.Откройте управление API-ключами
Войдите в аккаунт на сайте HTX и перейдите в Профиль → API Management (или откройте страницу API-ключей HTX ). На один аккаунт можно создать до 20 API-ключей.
2.Создайте API-ключ
Нажмите Create API Key и создайте ключ, который генерирует HTX (пара Access Key и Secret Key). В поле Note укажите название, например JetScalp. Название нужно только вам — чтобы отличать ключи друг от друга.
Не выбирайте вариант с собственным открытым ключом Ed25519: JetScalp подписывает запросы с помощью Secret Key и самостоятельно сгенерированные ключи не поддерживает.
3.Настройте разрешения
| Разрешение | Описание |
|---|---|
| Read | Информация об аккаунте, балансе, заявках и сделках. |
| Trade | Выставление и отмена заявок, переводы между счетами. |
| Withdraw | Вывод средств. |
Для работы JetScalp включите:
- Read
- Trade
- Withdraw
Названия разрешений могут отличаться в зависимости от версии интерфейса HTX.
Важно: Разрешение на вывод средств (Withdraw) JetScalp не нужно — не включайте его.
4.Ограничьте доступ по IP
Привяжите ключ к публичному IP-адресу, с которого JetScalp подключается к HTX. К одному ключу можно привязать до 20 IP-адресов. Если JetScalp работает через прокси, укажите IP-адрес, который HTX видит при подключении через этот прокси.
Ключ без привязки к IP истекает через 90 дней.
Если вы не знаете, какой IP указать, сначала выясните его: с неверным IP HTX отклонит подключение.
5.Подтвердите создание и сохраните ключ
Пройдите проверку безопасности (например, код из SMS или письма и код Google Authenticator). HTX покажет Access Key и Secret Key. Сразу скопируйте оба ключа.
Важно: Secret Key показывается только один раз. Если он потерян, удалите ключ и создайте новый.
6.Проверьте настройки фьючерсного счёта
Секция Фьючерсы работает через API V5 HTX, предназначенный для режима обеспечения Multi-Assets Collateral.
- Если фьючерсный счёт в прежнем режиме Single-Asset Collateral, JetScalp покажет предупреждение. Если заявки отклоняются, переведите счёт USDT-M в режим Multi-Assets Collateral в настройках HTX.
- JetScalp поддерживает фьючерсный счёт HTX только в режиме односторонней позиции (One-way). Если включён режим хеджирования, подключение не установится, и JetScalp покажет сообщение об этом. Переключите режим позиций в настройках HTX и подключитесь снова.
- Заявки HTX USDT-M JetScalp выставляет в кросс-марже.
Режимы счёта — ваши настройки на HTX, JetScalp их не меняет.
7.Добавьте подключение в JetScalp
Откройте Настройки → Подключения, нажмите Добавить подключение под списком подключений и щёлкните по плитке HTX. Подключение появится в списке, а справа — его настройки.
Заполните настройки подключения:
| Поле | Значение |
|---|---|
| Название | Название подключения в списке. По умолчанию — название биржи или брокера, его можно изменить. |
| Access Key | Access Key, полученный у HTX. |
| Secret Key | Secret Key, полученный у HTX. |
| Прокси | Прокси из списка или Нет. Подробнее — Настройка прокси. |
У HTX два рынка, поэтому в настройках подключения две секции — Спот и Фьючерсы, у каждой свой переключатель и своё состояние. Выключите секцию рынка, на котором не торгуете: JetScalp не будет к нему подключаться, а поля секции сохранятся.
8.Включите подключение и проверьте
Включите подключение переключателем справа в его строке в списке. Под названием подключения появится состояние: сначала подключение…, затем подключено. Если подключиться не удалось, там будет текст ошибки — полностью он виден в подсказке и в заголовке настроек подключения. Подробнее о состояниях — Подключения.
Проверьте:
- HTX подключён.
- Доступен баланс аккаунта.
- Доступны открытые позиции.
- Заявки выставляются и отменяются.
Если подключение не работает
Неверный Access Key или Secret Key
Проверьте, что оба ключа скопированы полностью и без лишних пробелов.
Недостаточно разрешений
Если котировки и информация об аккаунте работают, а заявки не выставляются, проверьте, что у ключа включено разрешение Trade.
Использован ключ Ed25519
JetScalp работает только с ключами, которые генерирует HTX (Access Key и Secret Key). Если вы создали ключ Ed25519, создайте вместо него обычный.
У ключа нет спотового счёта
Сообщение «HTX Spot: у ключа нет счёта spot. Подключение прервано.» значит, что HTX не вернул по ключу спотовый счёт. Проверьте, что в аккаунте HTX, где создан ключ, есть спотовый счёт. Если спотом не торгуете, выключите секцию Спот.
Настройки фьючерсного счёта
Если JetScalp сообщает о режиме хеджирования или прежнем режиме обеспечения счёта HTX USDT-M, измените соответствующую настройку в HTX (см. шаг 6).
Ограничение по IP
Если для ключа установлено ограничение по IP, убедитесь, что IP-адрес компьютера или прокси есть в списке разрешённых.
Срок действия ключа истёк
Откройте HTX → API Management и убедитесь, что ключ существует и действует. Ключ без привязки к IP истекает через 90 дней — создайте новый и по возможности привяжите его к IP.
Безопасность
Никому не передавайте Access Key и Secret Key — ни в чатах и Telegram, ни службе поддержки, ни на форумах, скриншотах и в публичных репозиториях.
Разрешение на вывод средств JetScalp не нужно — не включайте его.
Если ключ попал к посторонним или есть такое подозрение, сразу удалите его в HTX и создайте новый.