РАЗРАБОТЧИКИУзнай, как создать торгового бота с помощью API Cryptohopper и изменить конфигурацию своих ботов. В два простых шага мы создадим нового торгового бота и добавим настройки конфигурации к новому торговому боту.
Чтобы делать запросы к API, тебе нужно создать приложение и иметь токен доступа. Если ты еще не создал токен доступа, пожалуйста, сначала ознакомься с руководством Получить токен доступа с помощью Oauth2.
Шаг 1: Создание нового торгового бота
Чтобы создать нового торгового бота с помощью API, тебе нужно сделать POST-запрос к эндпоинту hopper. С помощью POST-запроса ты можешь сразу отправить значения конфигурации, но в этом примере мы отправим только несколько примеров конфигурации и настроим торгового бота на следующем шаге. Ниже ты найдешь эндпоинт API и JSON, который тебе нужно отправить с POST-запросом.
Эндпоинт API:
https://api.cryptohopper.com/v1/hopper
JSON POST:
{
"name": "Название твоего нового торгового бота.",
"enabled": 0
}
Когда запрос API будет успешным, ты получишь JSON-ответ со значением: id. Этот id — уникальный идентификатор твоего нового торгового бота. Сохрани id, потому что он понадобится тебе на следующем шаге, чтобы настроить конфигурацию торгового бота.
Шаг 2: Настройка твоего торгового бота
Теперь, когда мы создали нового торгового бота и у тебя есть id нового торгового бота, пришло время настроить торгового бота, чтобы ты мог начать автоматически торговать с ним. Все обновления твоего торгового бота будут выполняться путем доступа к эндпоинтам торгового бота с твоим id, например, /hopper/{id}. Чтобы обновить конфигурацию твоего торгового бота, тебе нужно сделать PATCH-запрос к этому эндпоинту. Ниже ты найдешь эндпоинт, куда тебе нужно отправить свой PATCH-запрос. Пожалуйста, замени {id} на id, который ты получил на шаге 1.
Эндпоинт API:
https://api.cryptohopper.com/v1/hopper/{id}
Тебе нужно будет отправить JSON-данные обновлений, которые ты хочешь сделать. Например, если ты хочешь изменить название своего торгового бота, тебе нужно снова отправить ключ name. Если ты не хочешь менять название, просто опусти это поле. Ниже ты найдешь пример JSON PATCH-запроса.
Пример JSON PATCH-запроса:
{
"name": "Новое название твоего нового торгового бота.",
"enabled": 0,
"api_config": {
"api_key": "Ключ API твоего биржевого аккаунта.",
"api_secret": "Секрет API твоего биржевого аккаунта."
},
"config": {
"exchange": "binance",
"collect_currency": "btc",
.... И другие параметры конфигурации
}
}
Давай рассмотрим некоторые из возможных параметров конфигурации в JSON-запросе.
| api_config | |
| api_key | Это ключ API, который ты создал на своей бирже. |
| api_secret | Это секрет API, который ты создал на своей бирже. |
| config | |
| exchange | Введи ключ биржи, которую ты хочешь подключить. Чтобы получить список всех бирж и ключей, перейди по ссылке: https://api.cryptohopper.com/v1/exchange |
| collect_currency | Это базовая валюта твоего торгового бота в нижнем регистре, например: btc, usd, eth. |
| allowed_coins | Массив монет (в верхнем регистре), которые торговый бот может автоматически покупать. Например: ["BTC", "LTC", "ETH"]. |
| perc_buy_amount | Процент от твоих общих активов, который будет использоваться для определения суммы покупки. |
| min_buy_amount | Минимальная сумма покупки для автоматических покупок. |
| max_amount_allocated | Максимальная сумма (в базовой валюте), выделенная твоему торговому боту. |
| strategy | Стратегия, которую ты хочешь настроить. Например: no_strategy, multiple_ta. Если ты хочешь настроить кастомную стратегию, тебе понадобится id стратегии и настроить ее как: user_{id}, например: user_1. |
| num_targets_per_buy | Количество целей, которые будут куплены, если твоя стратегия обнаружит несколько целей. |
| max_open_time_buy | Количество минут, в течение которых ордера на покупку могут оставаться открытыми, прежде чем они автоматически будут отменены. |
| max_open_time | Количество минут, в течение которых ордера на продажу могут оставаться открытыми, прежде чем они автоматически будут отменены. |
| set_percentage | Процент тейк-профита, который ты хочешь настроить, например: 1.5. |
Конечно, есть много других параметров конфигурации. Посмотри справочник по API для получения дополнительной информации об объекте config.
Когда ты успешно обновишь конфигурацию своего торгового бота, ты получишь ответ 200 с возвращенным объектом config целиком. Если запрос не удастся, ты получишь статус 400 с сообщением об ошибке, объясняющим эту ошибку.
Надеюсь, тебе удалось создать и настроить своего торгового бота после прочтения этого руководства. Теперь ты сможешь настроить конфигурацию своего торгового бота и добавить новых торговых ботов в свой аккаунт.